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Preface 


About  This  Manual 


This  is  the  reference  manual  for  the  Apple®  lie  personal  computer. 
It  contains  detailed  descriptions  of  all  the  hardware  and  firmware 
that  make  up  the  Apple  lie  and  provides  the  technical  information 
that  peripheral-card  designers  and  programmers  need. 

The  information  in  this  manual  is  aimed  at  assembly-language 
programmers  and  hardware  designers,  but  others  interested  in  the 
internal  operation  of  the  Apple  lie  can  also  benefit  from  reading  it. 

This  manual  tells  you  how  the  Apple  lie  works,  but  not  how  to  use  it. 
If  you  need  to  know  how  to  set  up  and  use  your  Apple  He,  read  the 
Apple  lie  Owner's  Manual. 

This  manual  describes  three  versions  of  the  Apple  IIc: 

n  the  original  Apple  IIc 

n  the  Apple  IIc  that  supports  the  UniDisk™  3.5  drive 

n  the  Apple  IIc  that  supports  the  Memory  Expansion  Card 

More  information  on  the  various  versions  of  the  Apple  IIc  is 
provided  under  "The  Apple  IIc  Family,"  later  in  this  Preface. 


Contents  of  ttiis  manual 

The  Apple  IIc  is  presented  in  this  manual  from  the  outside  in. 

Chapter  1  introduces  the  Apple  IIc,  including  external  controls, 
connectors,  and  the  main  internal  components. 

Chapter  2  introduces  the  65C02  microprocessor  and  its  directly 
addressable  memory  space. 

Chapter  3  introduces  the  I/O  characteristics  of  the  Apple  IIc. 
Chapters  4  and  9  cover  specific  areas  of  the  I/O  interface. 
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Chapter  4  describes  the  keyboard  and  speaker. 

Giapter  5  describes  the  video  display. 

Chapter  6  describes  block  device  I/O,  including  the  Smartport 
firmware  interface. 

Chapter  7  describes  serial  port  1. 

Chapter  8  describes  serial  port  2. 

Chapter  9  describes  the  mouse/game  paddle  port. 

Chapter  10  describes  the  Apple  He's  built-in  Monitor  firmware.  The 
Monitor  helps  you  write,  disassemble,  and  debug  machine- 
language  programs,  as  well  as  providing  you  with  a  means  to  look  at 
and  manipulate  the  contents  of  main  memory. 

Chapter  11  describes  the  Apple  lie  hardware  in  detail. 

Appendix  A  describes  the  65C02  microprocessor  in  detail, 
including  the  differences  between  it  and  the  6502  microprocessor 
used  on  early-model  Apple  II's.  Most  of  this  appendix  is  a  reprint  of 
the  manufacturer's  data  sheet  for  the  65C02. 

Appendix  B  contains  a  memory  map  of  die  Apple  Uc  main 
memory.  Detailed  maps  are  provided  for  memory  pages  $00  and 
$03,  the  screen  holes,  and  the  hardware  page. 

Appendix  C  lists  the  Apple  lie  firmware  entry  points,  including 
those  for  the  I/O  firmware  and  the  Monitor  firmware. 

Appendix  D  describes  some  of  the  operating  systems  and  languages 
supported  by  Apple  Computer  for  the  Apple  lie. 

Appendix  E  describes  the  operation  of  the  Apple  He  interrupt 
handler  firmware  and  how  to  use  it  in  your  programs. 

Appendix  F  outlines  the  differences  and  similarities  between  the 
diverse  members  of  the  Apple  II  family  of  computers. 

Appendix  G  describes  the  various  international  versions  of  the 
Apple  He  keyboard  and  character  set  Power  and  safety  information 
for  international  versions  of  the  Apple  He  is  also  included  in  this 
appendix. 

Appendix  H  contains  tables  to  aid  you  in  code  and  number  base 
conversions. 

Appendix  I  contains  the  firmware  listing  for  the  new  version  of  the 
Apple  nc  and  information  on  obtaining  listings  for  the  original  and 
UniDisk  3.5  ROMs. 

The  Glossary  defines  many  of  the  technical  terms  used  in  this 
manual. 
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The  Bibliography  lists  articles  and  books  with  additional 
information  about  the  Apple  lie. 

Finally,  after  the  index  at  the  back  of  this  manual,  you'll  find  the  Tell 
Apple  Card;  please  take  a  minute  to  fill  this  card  out  and  mail  it  back 
to  us.  Your  experience  with  this  and  other  Apple  manuals  can  help 
us  plan  new  reference  materials. 


The  Apple  lie  family 

Changes  have  been  made  to  the  Apple  lie  since  the  original  version 
was  introduced.  The  first  change  was  made  in  order  to  support  the 
UniDisk  3.5  external  drive,  and  included  a  set  of  ROM-based 
machine-language  routines  called  the  Protocol  Converter.  The 
latest  version  incorporates  all  the  UniDisk  3-5  upgrade  features,  a 
new  version  of  the  Protocol  Converter  called  the  Smartport,  and 
support  for  an  optional  memory  expansion  card.  All  of  these 
versions  are  described  in  this  manual.  Where  there  are  differences 
between  the  various  versions  of  the  Apple  lie,  they  will  be  called  out 
in  the  manual.  For  the  sake  of  convenience,  the  various  versions  of 
the  Apple  lie  are  identified  by  the  features  they  support,  such  as 
memory  expansion  for  the  newest  lie  and  UniDisk  3-5  for  the 
version  that  introduced  the  UniDisk  3.5  drive  support.  Unless 
specified,  all  versions  of  the  Apple  lie  operate  identically. 


Imporfant     Smartport  is  merely  a  new  name  for  the  Protocol  Converter;  all 
the  specifications  for  the  Smartport  apply  to  the  Protocol 
Converter,  and  vice  versa. 


Identifying  your  Apple  lie 

There  are  basically  three  versions  of  the  Apple  IIc: 

D  the  original  Apple  IIc 

n  the  UniDisk  3-5  Apple  IIc 

n  the  memory  expansion  Apple  IIc 

You  can  tell  which  Apple  IIc  you  have  by  checking  the  value  of  the 
ID  byte  at  ROM  location  64447  ($FBBF  in  hexadecimal).  The  value 
of  this  byte  is  255  ($FF)  in  the  original  Apple  IIc,  0  ($00)  in  the 
UniDisk  3.5  version,  and  3  ($03)  in  the  memory  expansion  version. 

♦  Checking  the  ID  byte:  You  can  check  the  value  of  the  ID  byte 
from  Applesoft  by  typing  PRINT  PEEK    (64447). 
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The  original  Apple  lie 

The  original  Apple  lie  is  the  oldest  member  of  the  lie  family.  It  has 
the  following  features: 

D  the  65C02  microprocessor 

D   128KofRAM 


The  UniDisk  3.5  Apple  lie 

The  Apple  lie  that  introduced  support  for  the  UniDisk  3.5  drive  is 
Identified  in  this  manual  as  the  UniDisk  3-5  version.  It  includes  the 
following  changes  from  the  original  Apple  IIc: 

D  the  Protocol  Converter,  to  support  the  UniDisk  3.5  external  disk 
drive 

n  a  256k  ROM  IC  to  replace  the  128K  ROM 

n  some  new  serial  port  commands 

D  the  Mini-Assembler 

D  two  new  Monitor  commands  (STEP  and  TRACE) 

n  built-in  diagnostics 

The  UniDisk  35  Apple  IIc  also  includes  improved  intermpt  handler 
features  and  new  external  drive  startup  procedures. 


The  memory  expansion  Apple  IIc 

The  Apple  IIc  that  supports  an  optional  memory  expansion  card 
supports  all  the  features  of  the  UniDisk  3.5  version.  It  includes  the 
following  changes  from  the  UniDisk  3.5  IIc: 

n  an  internal  connector  to  support  an  optional  memory  expansion 
card 

D  4  64Kx4  RAM  ICs  to  replace  the  l6  64Kxl  ICs 

The  Apple  IIc  that  supports  the  memory  expansion  option  also 
reorganizes  the  I/O  port  ("slot")  entry  points  in  the  firmware.  The 
mouse,  located  at  port  4  in  the  original  and  UniDisk  3-5  versions,  is 
now  at  port  7.  The  memory  expansion  card  uses  port  4  in  the  new 
Apple  IIc.  What  this  means  is  that  all  the  mouse  I/O  entry  point 
addresses  have  been  changed  from  $C4XX  to  $C7XX. 
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To  avoid  confusion  and  maintain  compatibility  with  previous 
versions,  the  text  and  tables  in  this  book  still  show  the  values  used 
for  the  original  and  UniDisk  3.5  versions  of  the  Apple  lie.  However, 
a  statement  reminding  you  of  the  change  appears  near  affected 
tables. 


Remember  that  the  Smartport  and  the  Protocol  Converter  are 
the  same  thing. 


Conventions  used  in  this  manual 

Special  text  in  this  manual  is  set  off  in  several  different  ways,  as 
shown  in  these  examples. 


Warning      Important  warnings  look  like  this.  These  flag  potential  danger  to 
the  Apple  lie,  its  software,  or  you. 


Important     Text  set  off  like  this  is  less  urgent  or  threatening  than  text  In  a 
Warning  box,  but  still  of  a  critical  nature. 


Original  lie      Text  set  off  like  this  applies  only  to  the  original  version  of  the 
Apple  lie. 


UniDisk  3.5      Text  set  off  like  this  applies  only  to  the  UniDisk  3.5  version  of  the 
Apple  lie. 


Memory  expansion      Text  set  off  like  this  applies  only  to  the  memory  expansion 
version  of  the  Apple  lie. 

♦  By  the  way:  Information  that  is  useful  but  incidental  to  the  text 
is  set  off  like  this.  You  may  want  to  skip  over  such  information 
and  return  to  it  later. 

Terms  that  appear  in  boldface  in  the  text  are  defined  in  the 
Glossary  or  a  marginal  gloss. 

Computer  voice  is  used  to  indicate  text  that  should  be  identical 
to  your  screen  display  or  printout. 
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Chapter  1 


Introduction 


This  chapter  introduces  you  to  the  working  parts  of  the  Apple  lie  by 
briefly  describing  the  major  components  of  the  computer — ^both 
internal  and  external  hardware  and  firmware — ^and  telling  you 
where  in  the  manual  to  find  out  more  about  them. 


The  outside  of  the  machine 

This  section  briefly  describes  the  Apple  He's  keyboard,  controls, 
indicators,  and  expansion  connectors. 

The  Apple  lie  comes  equipped  with  a  keyboard,  speaker  (with  audio 
output  jack  and  volume  control),  built-in  disk  drive,  external  power 
supply,  and  internal  voltage  converter.  It  also  has  built-in  interfaces 
with  external  connectors  for  a  serial  printer,  video  monitor,  special 
video  display  adapters,  modem,  mouse,  and  game  controllers. 
These  external  connectors  allow  you  to  plug  in  accessory  equipment 
without  having  to  go  inside  the  machine  to  use  expansion  slots  like 
those  in  the  Apple  lie. 

Figure  1-1  shows  the  front  and  right  side  of  an  Apple  lie,  and 
Figure  1-2  shows  the  back  and  left  side. 


Keyboard  Disk  Drive 

(See  Figs.  1-4  and  1-5)        (See  Fig.  1-7) 


Figure  1-1 

Apple  He  external  features, 
front 


Baci<  Panel 
(See  Fig.  1-8) 


Speal<er 

Volume  Control 

(See  Fig.  1-6) 


Figure  1-2 

Apple  He  external  features, 
back 
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The  keyboard 


ASCII  stands  for  American 
Standard  Code  for  Information 
Interctiange.  Table  4-2  lists  the 
ASCII  character  encoding  for 
the  standard  and  simplified  USA 
keyboards.  Appendix  G  lists  the 
encoding  for  International 
keyboards. 


The  Apple  He's  primary  input  device  is  the  keyboard,  shown  in 
Figure  1-3.  The  keyboard  has  a  63-key  typewriter  layout  with  both 
uppercase  and  lowercase  characters  and  can  generate  all  128 
standard  ASCII  characters.  A  reset  key,  80/40-column  display 
selector  switch,  keyboard  layout  selector  switch,  disk-use  light,  and 
power  light  are  also  located  on  the  front  of  the  computer. 


Reset  Switch  - 

80/40-Column  Switch - 

Keyboard  Switch  - 
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Disl<-Use  Light      Power  Light 

Figure  1-3 

Front  of  Apple  lie  with  standard  USA  l<eyboard 

Table  1-1  lists  the  characteristics  of  all  Apple  lie  keyboards  and 
front  panels. 


Features 

The  Apple  lie  keyboard  has  automatic  repeat  on  all  character  keys. 
This  means  that  if  you  hold  the  key  down  longer  than  about  a 
second,  the  character  it  generates  repeats  until  you  let  up  the  key.  It 
also  has  two-key  rollover,  which  means  if  you  press  a  key  before 
releasing  the  one  you  pressed  before  it,  the  second  character  enters 
the  computer  the  same  as  though  you  had  released  the  previous  key 
first.  (This  is  important  for  fast  touch-typists.) 


The  outside  of  the  machine 


Table  1-1 

Keyboard  specifications 


Number  of  keys 

Character  encoding 

Number  of  codes 

Features 

Special  function  l<eys 

Cursor  movement  l<eys 

Modifier  Iceys 
Front-panel  switches 
Front-panel  lights 


63 

ASCII 

128 

Automatic  fe^at,  twe-key  rollover 

Reset,  Open  Apple,  Solid  Apple, 

Left  Arrow,  Right  Arrow,  Down  Arrow, 

Up  Arrow,  Return,  Delete,  Tab 

Control,  Shift,  Caps  Lock,  Escape 

80/40  switch,  keyboard  switch 

Power  light,  disk-use  light 


The  Open  Apple  and  Solid  Apple 
keys  are  connected  to  1-bit 
addresses  in  memory,  described 
in  Chapter  9. 


Chapter  2  describes  the  results 
of  the  various  reset  procedures. 


Special  function  keys 

The  Apple  lie  keyboard  has  three  special  function  keys:  Reset,  and 
two  keys  marked  with  apples — one  outlined  (Open  Apple)  and  one 
filled  in  (Solid  Apple). 

Reset  has  a  direct  line  to  the  65C02  microprocessor's  RESET  signal 
line  (see  Chapter  11):  holding  down  Control  while  pressing  Reset 
causes  the  Apple  lie  to  restart  processing  with  an  internal  firmware 
program  that  puts  the  machine  in  a  known  state  (see  Chapter  2). 

You  can  restart  the  Apple  lie  without  turning  the  power  off  and  back 
on  again,  by  holding  down  both  Control  and  Open  Apple  while 
pressing  Reset.  Restarting  this  way  is  less  stressful  to  the  Apple  He's 
components  than  normal  powerup. 


Cursor  movement  keys 

The  Apple  lie  keyboard  has  four  cursor  movement  keys  with  arrows 
marked  on  them:  left,  right,  down,  and  up.  Three  other  keys  can 
also  cause  cursor  movements:  Return,  Delete,  and  Tab.  All  seven  of 
these  keys  generate  ASCII  control  characters  (see  Table  4-2).  It  is  up 
to  the  operating  system  or  application  program  to  interpret  and  act 
on  the  control  codes  that  these  keys  generate. 
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The  Monitor  Is  a  built-in  program 
that  performs  some  of  the  basic 
activities  of  the  computer,  such 
as  retrieving  and  storing  key 
codes  OS  they  come  In,  and 
clearing  or  updating  the  display 
screen. 


Modifier  l<eys 

Three  special  keys — Control,  Shift,  and  Caps  Lock — generate  no 
codes  when  pressed  by  themselves,  but  change  the  codes  generated 
by  other  keys  they  are  pressed  in  combination  with.  A  fourth  key, 
Escape,  generates  a  nonprinting  control  code  that  causes  the 
Monitor  to  interpret  certain  subsequent  keystroke  in  a  modified 
way. 

D  Control,  when  pressed  in  combination  with  letter  keys  or  certain 
other  keys,  produces  ASCII  control  characters.  Most  of  the 
control  characters  are  invisible  most  of  the  time. 

n  Shift  works  the  same  on  the  Apple  lie  as  on  an  ordinary 

typewriter:  it  selects  uppercase  letters  and  the  upper  characters 
on  the  keys. 

n  Caps  Lock,  in  its  down  position,  changes  the  letter  keys  to 
uppercase,  but  does  not  affect  other  keys. 

n  Escape  is  not  a  modifier  key  in  the  same  sense  as  Control  and 
Shift:  you  do  not  hold  it  down  while  pressing  other  keys.  Rather, 
you  press  Escape  and  it  generates  the  ASCII  escape  (ESC)  control 
character  (key  code  $1B — see  Table  4-2).  When  the  Escape  key  is 
pressed,  many  programs — including  the  built-in  Monitor 
program — then  interpret  other  specific  keys  as  designating  an 
escape  sequence. 

The  80/40  switch 

The  80/40  switch  lets  you  specify  whether  a  program  should  display 
information  in  40  or  80  columns  per  line.  The  switch  indicates  40- 
column  display  when  in  its  down  position,  and  80-column  display 
when  in  its  up  position. 


Important     Not  all  progranns  check  this  sv\/itch.  Even  programs  that  do 

check  the  svs/itch  may  do  so  only  v^i'hen  the  program  first  starts 
up.  If  that  is  the  case,  changing  the  sv\/ltch  position  while  the 
program  Is  running  W\\\  have  no  effect  on  the  program's  display, 
(See  Table  4-1.) 
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The  keyboard  switch 

You  use  the  keyboard  switch  to  select  for  use  one  of  the  two  keyboard 
layouts  and  screen  character  sets  built  into  your  Apple  lie.  On  USA 
versions  of  the  Apple  lie,  you  select  the  standard  Sholes  keyboard 
layout  (Figure  1-4)  with  the  switch  in  the  up  position,  and  the 
Dvorak  simplified  layout  (Figure  1-5)  with  the  switch  in  the  down 
position. 

If  you  normally  use  the  Dvorak  keyboard  layout,  you  can  gently  pry 
up  the  keys  from  the  keyboard  and  rearrange  and  replace  them  in 
their  Dvorak  positions. 
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USA  standard  (or  Sholes)  keyboard,  keyboard  switch  up 
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USA  simplified  (or  Dvoral<)  keyboard,  keyboard  switch  down  (sinaded  characters  may  be  in 
different  positions  on  some  modeis) 


Appendix  G  illustrates  the 
keyboard  layouts  for  both 
keyboard  switch  posltloris  on 
several  International  versions  of 
the  Apple  lie. 


On  international  models,  the  keycaps  indicate  the  character 
positions  for  the  local  keyboard  layout,  which  is  selected  when  the 
keyboard  switch  is  down.  When  up,  the  keyboard  switch  selects  the 
USA  standard  characters  and  key  layout. 


Disk-use  and  power  lights 

The  red  disk-use  light  glows  whenever  the  built-in  disk  drive's  motor 
is  switched  on. 

The  green  power  light  glows  when  the  Apple  lie  is  turned  on  and 
normal  power  is  present  at  the  Apple  He's  internal  power  supply. 


Warning      If  the  power  light  flashes  on  and  off,  turn  off  the  computer 

immediately.  Find  out  what  caused  the  condition  (such  as  a 
brownout  or  short  circuit)  and  fix  the  problem  before  turning 
the  computer  on  again.  Above  all,  do  not  use  the  disk  drive 
when  the  power  light  Is  flashing;  this  may  damage  the 
computer. 
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The  way  programs  control  the 
speaker  is  described  under 
"Speai<er  Output"  In  Chapter  4. 


The  speaker 

The  Apple  lie  has  a  speaker  in  the  bottom  of  the  case,  as  shown  in 
Figure  1-6.  The  speaker  lets  Apple  lie  programs  produce  a  variety  of 
sounds.  There  is  also  a  volume  control  on  the  left  side  of  the 
Apple  lie  case,  and  a  jack  for  connecting  headphones  or  an 
external  speaker.  The  jack  accepts  either  She-charfnel  (monaural) 
or  two-channel  (stereo)  plugs,  although  speaker  output  is  monaural 
only.  Inserting  a  plug  disconnects  the  built-in  speaker 


Volume  Control  Knob 
Speaker  (Inside) 
Audio  Output  Jack 


Figure  1  -6 

Speaker,  volume  control,  arid  audio  output  jack 


The  built-in  disl<  drive 

The  Apple  He's  built-in  disk  drive  (Figure  1-7)  is  fully  compatible 
with  the  Apple  Disk  lie  that  reads  and  writes  5.25-inch  single-sided 
35-track  disks.  The  drive  door  is  on  the  right  side  of  the  Apple  lie 
case. 
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Disk  Drive-Door 


Figure  1-7 

Built-in  disk  drive 


The  back  panel 

The  back  panel  of  the  Apple  lie  (Figure  1-8)  has  seven  connectors 
and  a  main  power  switch.  From  left  to  right  they  are 

n  a  9-pin  D-type  miniature  connector  for  connecting  hand 
controllers,  a  mouse,  a  joystick,  or  some  other  device  (see 
Chapters  9  and  11) 

D  a  5-pin  DIN  connector  for  serial  input  and  output  (port  2; 
normally  for  a  modem)  (see  Chapters  7  and  1 1) 

n  a  15-pin  D-type  connector  for  video  expansion  (see  Chapter  11) 

n  an  RCA-type  jack  for  a  video  monitor  (see  Chapter  1 1) 

D  a  19-pin  D-type  connector  for  connecting  one  or  more  external 
devices,  such  as  intelligent  disk  drives  (see  Chapters  6  and  1 1) 

n  another  5-pin  DIN  connector  for  serial  input  and  output  (port  1; 
normally  for  a  printer  or  plotter)  (see  Chapters  8  and  11) 

n  a  special  7-pin  DIN  connector  for  power  input  (see  Chapter  11) 

Before  attaching  cables  to  the  Apple  lie  back  panel  connectors,  be 
sure  to  move  the  handle  until  it  clicks  into  position  for  propping  up 
the  computer.  The  handle  should  be  down  whenever  the  computer 
is  running  so  that  it  can  maintain  proper  cooling  airflow. 

The  installation  manuals  for  external  devices  contain  instructions 
for  connecting  them  to  the  Apple  lie. 
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Hon 


Mouse  and  Hand 

Control  Connector 

(See  Figs.  11-37 

and  11-42) 


Serial  Port  2 

Connector 

(See  Fig.  11-30) 


Video  Expansion 

Connector 
(See  Fig.  11-25) 


Handle 


Serial  Port  1 

Connector 

(See  Fig.  11-30) 


Power 
Switch 


Video  Output 

Connector 
(See  Fig.  11-24) 


External 

Disk  Drive 

Connector 

(See  Fig.  1 1-26) 


External  Power 

Connector 
(See  Fig.  11-1) 


Figure  1  -8 

Back  panel  connectors 
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The  inside  of  the  machine 

Figure  1-9  shows  the  main  components  inside  the  Apple  lie 
computer. 


Voltage 
Converter 


Built-in 
Disk  Drive 


Main  Logic  Board 
(See  Figure  1-11) 


Speaker 
(underneath) 


Figure  1-9 

Inside  the  machine 


Complete  specifications  of  the 
Apple  He  power  supply  and 
voltage  converter  appear  in 
Chapter  11. 


The  internal  voltage  converter 

The  built-in  voltage  converter  operates  from  a  12  to  15  VDC  input 
source,  such  as  provided  by  the  external  power  supply  furnished 
with  the  Apple  lie  (Figure  1-10).  The  voltage  converter  provides 
power  for  the  logic  board,  built-in  disk  drive,  one  external  disk 
drive,  and  the  I/O  signals  available  at  the  back  panel. 
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n 


Internal  Voltage  Converter 


Power  Switch 


Power  Supply 


Figure  1-10 

Power  supply  and  voltage  converter 

The  voltage  converter  produces  three  different  voltages:  +5V, 
+12V,  and  -12V.  (Minus  5V,  needed  by  some  components  in  the 
Apple  lie,  is  derived  from  -12V  on  the  main  logic  board.)  It  is  a 
high-efficiency  switching  converter  that  protects  itself  and  the  rest 
of  the  Apple  lie  against  short  circuits  and  other  electrical  mishaps. 


The  main  logic  board 

The  main  logic  board,  which  is  mounted  flat  in  the  bottom  of  the 
Apple  lie's  case,  has  almost  all  the  electronic  parts  of  the  computer 
attached  to  it. 
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Firmware  is  program  code  Vnai  is 
stored  in  ROIV1.  It  can  be  read 
and  executed,  but  not  cl^anged. 


Figure  1-11  shows  the  main  logic  board  and  the  most  important 
integrated  circuits  (ICs)  in  the  Apple  lie.  They  are  the  CPU  (central 
processing  unit),  RAM  (random-access  memory),  ROM  (read- 
only memory)  ICs  for  keyboard  encoding,  display  character 
generation,  and  firm-ware,  and  the  five  custom  ICs. 

The  processor  is  a  65C02  microprocessor.  The  65C02  is  a  CMOS 
version  of  the  6502  used  in  other  members  of  the  Apple  II  family.  It 
is  an  8-bit  microprocessor  with  a  l6-bit  address  bus.  In  the 
Apple  lie,  the  65C02  runs  at  1  MHz  and  performs  up  to  500,000  8-bit 
operations  per  second. 


Character  Generator  ROM 
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GLU 

Auxiliary  RAIVI 


Main  RAIVI- 

lOU 

MMU 

Keyboard  ROM 

65C02  Microprocessor 

Firmware  ROM 


Figure  1-11 

Original  and  UnlDlsk  3.5  lie  main  logic  board 
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The  Applesoft  language 
interpreter  is  described  in  the 
Applesoft  Tutorial  and  the 
Applesoft  BASIC  Programmer's 
Reference  Manual. 


Figure  1-12 

Memory  expansion  lie  main  iogic  board 

The  keyboard  is  scanned  by  an  IC  that  generates  matrix  values  for  a 
ROM.  The  value  of  the  ASCII  code  supplied  by  the  ROM  is  latched  at 
a  specified  memory  location  and  is  readable  by  programs. 

The  character  generator  ROM  converts  ASCII  character  values  to  a 
form  that  the  video  display  can  use. 

The  other  ROM  contains  the  Monitor,  the  Applesoft  BASIC 
interpreter,  enhanced  video  firmware,  and  other  input/output 
firmware.  The  firmware  that  this  ROM  contains  is  described 
throughout  this  manual. 
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For  more  on  memory  addressing, 
see  Chapter  2. 

See  Chapters  3  through  9, 


Chapter  1 1  discusses  the 
functions  of  these  Integrated 
circuits  in  some  detail. 


Five  of  the  large  ICs  on  the  main  logic  board  are  custom-made  for 
the  Apple  IIc: 

n  The  memory  management  unit  CMMU)  contains  most  of  the 
logic  that  controls  memory  addressing  in  the  Apple  IIc. 

D  The  input/output  unit  (lOU)  contains  most  of  the  logic  that 
controls  the  built-in  input  and  output  features  of  the  Apple  IIc. 

n  The  timing  generator  OMG)  generates  all  the  system  and  I/O 
clock  and  timing  signals  from  a  14-MHz  oscillator. 

n  The  general  logic  unit  (GLU)  performs  the  remaining  required 
logic  functions. 

n  The  disk  controller  unit,  also  known  as  the  Integrated  Woz 
Machine  (IWM),  is  a  single-chip  version  of  the  Apple  Disk  II 
controller  card.  It  controls  the  built-in  and  external  disk  drives 
connected  to  the  Apple  IIc. 


The  other  circuit  boards 

The  Apple  IIc  contains  other  circuit  boards  that  serve  special 
purposes:  a  motor-speed  control  and  read/write  logic  board  for  the 
disk  drive,  and  a  matrix  board  for  detecting  the  position  of  keys 
pressed.  This  manual  does  not  discuss  these  circuit  boards. 


Warning      Adjustment  of  disk  drive  speed  must  be  done  by  an  authorized 
Apple  Service  Center.  Do  not  attempt  to  adjust  Vr\e  speed  of 
your  built-in  disk  drive.  If  you  do,  you  may  damage  It  and  you 
will  void  your  warranty. 


The  inside  of  the  machine 
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This  chapter  introduces  the  Apple  He's  processor,  the  65C02,  and 
the  memory  ranges  and  locations  in  the  Apple  lie  that  have  been  set 
aside  for  special  purposes.  The  last  section  of  this  chapter  describes 
the  reset  routines,  which  restore  the  computer  to  a  known  state. 


Each  of  the  other  registers  holds 
eight  bits  (one  byte),  so  the 
65C02  is  called  on  8-bit 
processor. 


Appendix  A  lists  the  instructions 
the  65C02  can  carry  out,  their 
use,  and  their  effects  on  the 
registers.  For  further 
information,  consult  the 
pertinent  books  listed  in  the 
Bibliography. 


The  65C02  microprocessor 

The  65C02  is  a  general-purpose  8-bit  CMOS  microprocessor  similar 
in  operation  to  the  6502  used  in  other  members  of  the  Apple  II 
family  of  computers. 

Figure  2-1  is  a  model  of  the  65C02  microprocessor's  register 
organization.  Registers  are  fast-acting  built-in  storage  areas  where 
the  processor  performs  and  keeps  track  of  its  work.  The  65C02  has 
one  l6-bit  register  and  five  8-bit  registers. 

The  l6-bit  register  is  called  the  program  counter  (IPC).  It  specifies 
the  address  in  memory  that  contains  the  instruction  the  processor  is 
currently  carrying  out.  A  l6-bit  register  can  specify  any  one  of 
65,536  memory  addresses,  and  so  the  65C02  is  said  to  have  an 
address  space  of  65,536  locations. 

The  five  8-bit  registers  in  the  65C02  are  the  following: 

a  The  accumulator,  or  A  register.  The  accumulator  is  Uke  a  desk 
top  where  the  processor  performs  mathematical  and  logical 
operations  on  information. 

□  The  index  registers,  X  and  Y.  The  processor  uses  these  registers 
to  modify  the  address  where  information  is  to  be  found  or 
placed,  and  to  pass  information  from  one  program  to  another. 

n  A  stack  pointer,  or  S  register.  The  processor  uses  a  256-byte 
region  of  memory — page  $01 — as  an  area  to  stack  up  bytes  for 
future  use.  The  stack  is  empty  when  the  computer  is  turned  on. 
Several  65C02  instructions  either  push  (store)  the  contents  of  a 
register  onto  the  stack,  or  pull  (retrieve)  a  byte  from  the  stack  and 
place  it  in  a  register.  The  S  register  keeps  track  of  the  address  of 
the  byte  in  the  stack  that  is  currently  ready  for  use. 

n  A  processor  status  register,  or  P  register.  Seven  of  the  eight  bits  of 
this  register  are  used  as  flags  to  record  the  outcome  of  processor 
activities,  and  can  be  checked  by  later  instructions  to  determine 
what  has  happened  and  what  the  processor  should  do  next. 
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Figure  2-1 

Internal  model  of  the  65C02  microprocessor  (copyright  < 
used  by  permission) 


1982  by  NCR  Corporation; 


The  65C02  microprocessor 
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Soft  switches  are  described 
more  fully  under  "Bank- 
Switched  Memory"  and  '48K 
Memory.' 


There  ore  two  other  ROMs  in  the 
Apple  lie:  one  to  generate 
characters  corresponding  to 
keystrokes  and  another  to 
generate  characters  for  display. 
(See  "The  Keyboard"  and  "The 
Video  Display"  in  Chapter  9.) 
However,  these  ROMs  are  not 
addressable  by  the 
microprocessor. 


Overview  of  the  address  space 

The  Apple  He's  65C02  microprocessor  can  address  65,536  (64K) 
memory  locations.  All  the  Apple  He's  RAM,  ROM,  and  input  and 
output  (I/O)  devices  are  accessed  using  addresses  in  this  64K 
address  range.  Some  functions  have  the  same  addresses — but  not  at 
the  same  time.  The  Apple  lie  controls  its  shared  addresses  by  using 
soft  switches.  A  soft  switch  is  a  memory  location  that  controls 
some  aspect  of  the  computer's  operation  when  it  is  accessed. 

All  input  and  output  in  the  Apple  lie  is  memory  mapped — that  is, 
specific  memory  addresses  (all  in  the  $C0  page)  are  allocated  to 
each  I/O  device.  In  this  chapter,  the  I/O  memory  spaces  are 
described  simply  as  areas  of  memory.  For  details  of  the  built-in  I/O 
features  and  firmware,  refer  to  the  descriptions  in  Chapters  3 
through  9. 

A  contiguous  block  of  256  address  locations  in  the  65C02's  address 
range  is  called  a  page.  A  1-byte  address  counter  or  8-bit  register  can 
specify  1  of  256  different  locations.  Thus,  page  $00  consists  of 
memory  locations  from  0  through  255  (hexadecimal  $00  through 
$FF);  page  $01  consists  of  locations  256  through  511  (hexadecimal 
$0100  through  $01FF);  and  so  on.  In  this  manual,  all  page  numbers 
are  given  in  hexadecimal  format. 

♦  Note:  The  first  two  digits  of  a  four-digit  hexadecimal  address  are 
the  page  number.  There  are  256  pages  of  256  bytes  each  in  the 
address  space.  This  kind  of  page  is  different  from  the  display 
areas  in  the  Apple  lie,  v/hieh  are  sometimes  referred  to  as 
Page  1  and  Page  2.  In  this  manual,  dollar  signs  ($)  in  addresses 
signify  that  the  addresses  are  in  hexadecimal  notation. 


Memory  map  and  memory  switching 

Figure  2-2  is  a  map  of  the  Apple  He's  memory  address  space  and 
what  the  major  blocks  of  addresses  are  used  for.  As  you  can  see  in 
the  figure,  addresses  $C000  through  $C0FF  contain  hardware  only, 
and  addresses  $C100  through  $CFFF  contain  ROM  only.  At  all 
other  addresses  there  are  two  to  five  blocks  of  RAM  or  ROM 
locations.  At  any  given  time,  only  one  block  of  RAM  or  ROM 
occupies  each  set  of  addresses.  As  described  later  in  this  chapter, 
soft  switches  in  the  hardware  page  control  that  blocks  the  processor 
is  currently  using. 
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Apple  lie  memory  map 


Memory  map  and  memory  switching 
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Main  RAM  addresses  ($0000-$BFFF 
and  $DOOO-$FFFF) 

The  area  labeled  Main  RAM  in  Figure  2-2  is  so  called  because  some 
or  all  of  it  is  present  in  all  models  of  the  Apple  II  series  of 
computers.  The  Apple  lie  has  64K  bytes  of  main  RAM. 


Auxiliary  RAM  addresses  ($0000-$BFFF 
and  $DOOO-$FFFF) 

The  Apple  lie  has  64K  of  auxiliary  RAM  built  in.  Some  or  all  of  that 
range  of  auxiliary  memory  is  present  in  an  Apple  He  with  one  of  the 
80-column  text  cards  installed  (see  Appendix  F),  but  there  is  no 
auxiliary  RAM  in  the  Apple  II  or  II  Plus. 

A  range  of  addresses  in  auxiliary  RAM  cannot  be  used 
simultaneously  with  the  same  range  of  addresses  in  main  RAM;  your 
programs  must  use  the  soft  switches  described  in  this  chapter  to 
select  either  main  or  auxiliary  memory  for  any  given  range  of 
addresses. 


ROM  addresses  ($C100-$FFFF) 

ROM  addresses  contain  the  built-in  Apple  lie  firmware.  Addresses 
$C100  through  $CFFF  belong  exclusively  to  ROM.  Addresses  $DO0O 
through  $FFFF  are  shared  by  ROM,  main  RAM,  and  auxiliary  RAM; 
the  selection  techniques  are  described  later  in  this  chapter. 

The  Apple  lie's  built-in  ROM  pages  $C1  through  CF  (addresses 
$C100  through  $CFFF)  contain  I/O  firmware.  The  Apple  lie  I/O 
firmware  is  roughly  divided  among  the  built-in  I/O  devices  as 
follows: 

D  Serial  port  1  (RS-232  device)  firmware  entry  points  are  on 

page  $C1.  Much,  but  not  all,  of  the  firmware  for  the  port  is  in  the 
$C100  space. 

D  Serial  port  2  (communication  device)  firmware  entry  points  are 
on  page  $C2.  Much,  but  not  all,  of  the  firmware  for  the  port  is  in 
the  $C100  space. 
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The  operation  of  the  Applesoft 
interpreter  firmware  is 
described  in  the  Applesoft 
BASIC  Programmer's  Reference 
Manual. 


a  Video  output  firmware  entry  points  are  on  page  $C3;  the 
enhanced  video  firmware  and  miscellaneous  I/O  support 
routines  occupy  pages  $C8  through  $CF.  This  is  partly  because 
there  are  no  slots  8  through  F  on  the  Apple  lie  and  because  the 
firmware  takes  up  more  than  one  page  of  firmware  memory 
space. 

n  Mouse  firmware  entry  points  are  on  page  $C4  Cpage  $C7  in  the 
memory  expansion  version). 

D  Block  device  I/O  firmware  entry  points  are  on  page  $C6. 

♦  Note:  This  correspondence  of  ports  and  entry  points  does  not 
imply  that  all  of  each  port's  firmware  occupies  a  specific  page. 
The  Apple  lie  I/O  port  firmware  space  is  allocated  in  a  way  that 
provides  the  best  possible  performance  in  the  available  space. 

The  ROM  address  range  of  pages  $D0  through  $FF  contain  the 
Applesoft  BASIC  interpreter  and  the  Monitor  firmware,  allocated  as 
follows: 

D  Pages  $D0  through  $F7  (addresses  $D000  through  $F7FF) 
contain  the  Applesoft  interpreter  firmware. 

n  Pages  $F8  through  $FF  (addresses  $F800  through  $FFFF)  contain 
the  Monitor,  described  in  Chapter  10.  You  can  use  some  of  the 
built-in  Monitor  routines  to  make  input  and  output  procedures  in 
your  assembly-language  programs  easier  to  write.  These  routines 
are  described  in  Chapters  3  through  9. 


Chapters  3  through  9  describe 
the  Apple  lie's  input  and  output 
locations.  Appendix  B  lists  these 
locations  in  address  order,  rather 
than  by  function. 


Bit  numbering  in  a  byte  is 
explained  in  Appendix  H. 


Hardware  addresses  ($COOO-$COFF) 

The  soft  switches  that  the  Apple  lie  and  your  programs  use  to 
control  the  Apple  He's  built-in  input  and  output  functions  are  all 
found  in  the  $C0  memory  page  (addresses  $C000  through  $COFF). 
In  the  same  range  of  memory  are  the  switches  for  selecting  blocks  of 
memory  throughout  the  address  space.  This  chapter  describes  the 
address  space  (memory)  switches. 

The  hardware  functions  of  the  switches  in  this  page  fall  into  five 
basic  categories: 

n  Data  inputs.  The  only  data  input  is  location  $C000,  where  the 
low-order  seven  bits  (bits  6  through  0)  represent  the  keyboard 
key  just  pressed.  (These  data  are  guaranteed  valid  only  when 
bit  7  =  1.) 

D  Flag  inputs.  Most  built-in  input  locations  are  single-bit  flags  in 
the  high-order  (bit  7)  position  of  their  respective  memory 
addresses.  Flags  have  only  two  values:  on  (greater  than  or  equal 
to  128  or  $80)  or  off  Oess  than  128  or  $80). 


Memory  map  and  memory  switching 
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The  switch,  hand  controller  (analog)  and  button  inputs,  and  the 
keyboard  strobe  are  examples  of  flag  inputs.  The  locations  for 
reading  soft-switch  states  are  also  of  this  type. 

D  Strobe  outputs.  The  clear  keyboard  strobe  (Chapter  4)  and 
paddle  timer  strobe  (Chapter  9)  outputs  are  controlled  by 
memory  locations.  If  your  program  reads  the  contents  of  one  of 
these  locations,  then  the  function  associated  with  that  location 
will  be  activated. 

D   Toggle  switches.  The  Apple  lie  has  only  one  toggle  switch:  the 
speaker  switch.  A  toggle  switch  has  only  one  address  assigned  to 
it;  each  time  you  access  it,  it  changes  to  its  other  state  (on  or  off). 

Reading  the  speaker  toggle  at  location  $C030  clicks  the  speaker 
once.  However,  if  you  write  to  the  speaker  location,  the 
microprocessor  activates  the  address  bus  twice  during  successive 
clock  cycles,  causing  the  speaker  toggle  to  end  up  in  its  original 
state  before  the  speaker  cone  can  move.  Therefore,  you  should 
read,  rather  than  write,  to  use  this  device. 

The  processor  cannot  read  the  on/off  status  of  the  speaker 
switch. 

D  Soji  switches.  Soft  switches  are  two-position  switches  turned  on 
by  accessing  one  address  and  turned  off  by  accessing  another 
address.  Most  of  these  switches  have  a  third  address  associated 
with  them  for  reading  the  state  of  the  switch. 

There  are  eight  soft  switches  that  select  different  combinations  of 
bank -switched  memory.  Four  of  these  eight  switches  require  that 
your  program  read  them  twice  in  succession  to  activate  them. 


Bank-switched  memory 

The  memory  areas  described  in  this  section  are  called  bank- 
switched  memory  (Figure  2-3)  because  so  many  banks  (ranges)  of 
addresses — one  bank  of  ROM  and  up  to  four  banks  of  RAM — occupy 
the  same  group  of  locations  among  the  upper  addresses  of 
memory.  Pages  $00  and  $01,  at  the  low  end  of  memory,  are 
included  here  because  the  two  sets  of  them — one  in  main  RAM  and 
one  in  auxiliary  RAM — are  controlled  by  the  same  switches  as  the 
high-address  banks.  The  stack  and  zero  page  are  switched  this  way 
so  that  system  software  running  in  the  bank-switched  memory  space 
can  maintain  its  own  stack  and  zero  page  while  it  manipulates  the 
48K  memory  space. 
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Auxiliary  RAM 
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Figure  2-3 

Bank-switched  memory  map 
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Page  allocations 

Pages  $00  and  $01  are  used  by  many  of  the  65C02  instructions.  The 
ROM  and  RAM  addresses  in  bank-switched  memory  are  usually 
occupied  by  system  software  such  as  interpreters,  compilers,  and 
operating  systems. 


Page  $00  (one-byte  addresses) 

Several  of  the  65C02  microprocessor's  addressing  modes — for 
example,  indirect  addressing — require  the  use  of  addresses  in  page 
$00,  or  zero  page.  However,  the  Monitor,  the  interpreters,  and  the 
operating  systems  all  make  extensive  use  of  page  $00,  too.  One  way 
to  avoid  conflicts  is  to  use  only  those  page-$00  locations  not 
already  used  by  these  other  programs.  But  there  is  another  way. 

As  you  can  see  from  Table  B-1  in  Appendix  B,  page  $00  is  pretty 
well  used  up,  except  for  a  few  bytes  here  and  there.  Rather  than 
trying  to  squeeze  your  data  into  an  unused  corner,  you  may  prefer  a 
safer  alternative:  turn  off  interrupts,  save  the  contents  of  part  of 
page  $00,  use  that  part,  then  restore  the  previous  contents  to  page 
$00,  restore  interrupts  to  their  previous  state,  and  then  pass  control 
to  another  program. 

Page  $01  (the  65C02  stack) 

The  65C02  microprocessor  uses  page  $01  as  its  stack — a  place  where 
it  can  store  subroutine  return  addresses,  in  last-in,  first-out 
sequence.  Programs  can  also  use  the  stack  for  temporary  storage  of 
registers  (via  push  and  pull  instructions).  However,  programs 
should  use  the  stack  carefully. 


These  memory  banks  are 
controlled  by  the  soft  switches 
described  under  "Using  Bonk 
Selector  Switches." 


Pages  $D0-$FF  (ROM  and  RAM) 

The  memory  address  space  from  locations  $IX)00  through  $FFFF  is 
used  for  both  ROM  and  RAM.  The  12K  bytes  of  ROM  in  this  address 
space  contain  the  Monitor  and  the  Applesoft  BASIC  interpreter. 

There  are  16K  bytes  of  main  RAM  in  this  12K  space,  with  two  banks 
occupying  the  4K  of  addresses  from  $D000  through  $DFFF.  The 
RAM  is  normally  used  for  storing  other  languages  such  as  Pascal,  or 
operating  systems  such  as  ProDOS®. 

There  are  also  16k  bytes  of  auxiliary  RAM  in  this  12K  space,  again 
with  double  occupancy  in  the  address  range  $D000  through  $DFFF. 
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Using  bank  selector  switches 

You  switch  banks  of  memory  in  the  same  way  you  switch  other 
functions  in  the  Apple  IIc:  by  using  soft  switches.  These  soft  switches 
do  four  things: 

D  select  either  RAM  or  ROM  in  this  memory  space 

n  allow  or  inhibit  (write-protect)  writing  to  the  RAM  when  RAM  is 
selected 

n  select  the  first  or  second  4K-byte  bank  of  RAM  in  the  address 
space  $D000  through  $DFFF 

n  select  either  main  RAM  or  auxiliary  RAM 


Warning  Do  not  use  soft  switches  without  carefui  pianning.  Careless 
switching  between  RAM  and  ROM  Is  almost  certain  to  have 
catastrophic  effects  on  your  program. 

Table  2-1  shows  the  addresses  of  the  soft  switches  for  selecting  all 
allowed  combinations  of  reading  and  writing  in  this  memory  space, 
and  the  addresses  of  the  locations  to  read  the  switch  settings. 
Figures  2-4  through  2-10  illustrate  how  to  select  the  combinations 
and  what  the  resulting  status  of  each  switch  is. 

To  make  sure  you  do  not  inadvertently  remove  write  protection 
from  bank-switched  RAM,  the  four  write-enable  addresses  require 
that  you  read  them  twice  in  succession  (indicated  by  RR  in 
Table  2-1). 

Because  the  AltZP  switch  shares  the  read  keyboard  address,  you 
must  write  iWm  Table  2-1)  to  its  locations  to  change  the  switch 
setting. 

To  find  out  which  way  a  switch  is  set,  read  the  appropriate  location 
and  then  check  bit  7  (shown  as  J?7in  Table  2-1).  If  the  bit  is  a  1,  the 
answer  to  the  question  given  in  the  table  is  affirmative. 

Note  that  there  is  no  way  to  check  whether  write  protection  is  on  or 
off. 


Important     You  can't  read  one  RAM  banl<  and  write  to  the  other;  if  you 

select  either  RAM  bonk  for  reading,  you  get  that  one  for  writing 
as  well.  However,  you  can  read  ROM  and  write  RAM 
(Figures  2-5  and  2-6),  which  makes  It  easy  to  transfer  firmware 
to  bank-switched  RAM  if  you  want  to  use  It  with  a  program 
there. 
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Table  2-1 

Bank  selector  switches 


Name 


Acflon       Hex 


Dec 


Function 


R 

$C080 

49280 

Read  RAM;  no  write; 
use  $D000  bank  2 

RR 

$C081 

49281 

Read  ROM;  write  RAM; 
use$DOOO  bank  2 

R 

$C082 

49282 

Read  ROM;  no  write; 
use  $D000  bank  2 

RR 

$C083 

49283 

Read  and  write  RAM; 
use  $D000  bank  2 

R 

$C088 

49288 

Read  RAM;  no  write; 
use  $D000  bank  1 

RR 

$C089 

49289 

Read  ROM;  write  RAM; 
use$D000  bank  1 

R 

$C08A 

49290 

Read  ROM;  no  write; 
use  $DOO0  bank  1 

RR 

$C08B 

49291 

Read  and  write  RAM; 
use  $D000  bank  1 

RdBnk2           R7 

$con 

49169 

Read  whether  $D000 
bank  2  (1)  or  bank  1  (0) 

RdLCRAM       R7 

$C012 

49170 

Read  RAM  (1)  or 
ROM  CO) 

AltZP               W 

$C008 

49160 

Off:  Use  main  bank, 
page  $00  and  page  $01 

AltZP                W 

$C009 

49161 

On:  Use  auxiliary  bank, 
page  $00  and  page  $01 

RdAltZP          R7 

$C016 

49174 

Read  whether 
auxiliary  (1)  or 
main  (0)  bank 
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Select  memory: 
W    $C008 
R 
or    R 


ROM 


Turn  off  AltZP 
$C082        Read  ROM,  use  bank  2* 
$C08A       Read  ROM,  use  bank  1  * 

Main  RAM              Auxiliary  RAM 
I 1       I 


Select  memory: 
W    $C009 
R     $C082 


ROM 


Page  $01  C 
Page  $00  C 


Bank 
1 

Bank 
2 

Bank 

1 

Bank 
2 

Turn  on  AltZP 
Read  ROM,  use  bank  2* 
or    R     $C08A        Read  ROM,  use  bank  1* 

Main  RAM  Auxiliary  RAM 


r 


1      r 


n 


Bank 

1 


Bank 
2 


Bank 
1 

Bank 
2 

Read  resulting  status: 

R7    $C016        Read  AltZP;  bit  7  =  0 

R7    $C01 1       "Read  Bank2;  bit  7  =  1  or  0 

R7    $C012        Read  EnLCRAM;  bit  7  =  0 


Read  resulting  status: 

R7    $0016  Read  AitZP;  bit  7  =  1 

R7    $C011         *  Read  Bank2;  bit  7  =  1  or  0 

R7    SC0 1 2  Read  EnLCRAM;  bit  7  =  0 


Legend: 


Read  memory  [ =  Inactive  memory 

Write  memory  R     =   Read 


R7  =  Read,  check  bit  7 
W    =  Write 


RR  —  Read  twice  in  succession 


Figure  2-4 

Read  ROM 
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Select  memory: 

W       $C008        Turn  off  AltZP 
RR     $C089 


Select  memory: 

W      $C009        Turn  on  AltZP 
RR     $C089 


ROM 


Main  RAM              Auxiliary  RAM 
I 1       I 1 


ROM 


Page  $01  Q 
Page  $00  C 
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1  1  1 

Bank 
2 

Bank 
1 

Bank 
2 

Main  RAM  Auxiliary  RAM 

1       I 


Bank 

1 

Bank 
2 

Read  resulting  status: 

R7  $C016  Read  AltZP:  bit  7  =  0 
R7  $CC11  Read  Bank2:  bit7  =  0 
R7    $CC12        Read  EnLCRAM:  bit  7  =  0 


Read  resulting  status: 

R7    $00 16        Read  AltZP;  bit  7  =  1 
R7    $C01 1        Read  Bank2;  bit  7  =  0 
R7    $C012        Read  EnLCRAM;  bit  7  =  0 


Legend: 


=   Read  memory  |         |   =  Inactive  memory  R7   =  Read,  check  bit  7  RR  =  Read  twice  in  succession 

=  Write  memory  R     =   Read  W    =  Write 


Figure  2-5 

Read  ROM,  write  RAM,  and  use  first  $D0  bank 
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Select  memory. 
W      $C008 
RR     $C081 


Turn  off  AltZP 


Select  memory: 

W      $C009        Turn  on  AltZP 
RR    $C081 


c 
a 
CO  _ 


Page  $01  Q 
Page  $00  C 


Main  RAM 


Auxiliary  RAM 
I 1 


ROM 


Bank 
1 


Read  resulting  status: 

R7  $C016  Read  AltZP;  bit  7  =  0 
R7  $C01 1  Read  Bank2;  bit  7  =  1 
R7    $C012        Read  EnLCRAM;  bit  7  -  0 


Bank 
2 


Main  RAM              Auxiliary  RAM 
I 1       I 


Bank 
1 

Bank 
2 

Read  resulting  status: 

R7    $C016  Read  AltZP;  bit  7  =  1 

R7    $C01 1  Read  Bank2;  bit  7  =  1 

R7    $C012  Read  EnLCRAM;  bit7  =  0 


Legend: 


=   Read  memory  |         |   =  Inactive  memory  R7  =  Read,  cfieck  bit  7 

=  Write  memory  R     =   Read  W    =  Write 


RR  =  Read  twice  In  succession 


Figure  2-6 

Read  ROM,  write  RAM,  and  use  second  SDObank 
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Select  memory: 

W    $C008        Turn  off  AltZP 
R     $C088 


Select  memory: 
W    $C009 
R     $C088 


Turn  on  AltZP 


ROM 


Main  RAM 


Auxiliary  RAM 
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Read  resulting  status: 

R7  $C016  Read  AltZP;  bit  7  =  0 
R7  $C01 1  Read  Bank2;  bit  7  =  0 
R7    $C012        Read  EnLCRAM;  bit  7  =  1 


Read  resulting  status: 

R7    $0016       Read  AltZP;  bit  7  -  1 
R7    $cai1        Read  Bank2;  bit  7  =  0 
R7    $0012        Read  EnLCRAM;  bit7  =  1 


Legend: 


=  Read  memory 
=  Write  memory 


[         [   =   Inactive  memory 
R     =   Read 


R7  =  Read,  ctieck  bit  7 
W    =  Write 


RR  =  Read  twice  in  succession 


Figure  2-7 

Read  RAM  and  use  first  $D0  bank 


32 


Chapter  2;  Memory  Organization  and  Controi 


Select  memory: 

W    $C008        Turn  off  AltZP 
R     $COSO 


Select  memory: 

W    $C009        Turn  on  AltZP 
R     $C080 
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Read  resulting  status: 

R7  $C016  Read  AltZP;  bit  7  =  0 
R7  $C01 1  Read  Bank2;  bit  7  -  1 
R7    $C012       Read  EnLCRAM;  bit  7  =  1 


Bank 
1 

Bank 
2 

1 

Bank 
1 

|Bank| 

Read  resulting  status: 

R7    $C016  Read  AltZP;  bit  7  =  1 

R7    $C01 1  Read  Bank2;  bit  7  =  1 

R7    $CC12  Read  EnLCRAM;  bit  7  =  1 


Legend: 


=   Read  memory  [      H   =  Inactive  memory 

=  Write  memory  R     =    Read 


R7  =  Read,  check  bit  7 
W    =  Write 


RR  =  Read  twice  in  succession 


Figure  2-8 

Read  RAM  and  use  second  $D0  bank 
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Select  memory; 
W  $C008 
RR     $C08B 


Turn  off  AltZP 


Select  memory: 
W  $C009 
RR     $C08B 


Turn  on  AltZP 
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Read  resulting  status: 

R7  $C016  Read  AltZP;  bit  7  =  0 
R7  $C011  Read  Bank2;  bit  7  =  0 
R7    $C012        Read  EnLCRAM;  bit  7  =  1 


Read  resulting  status: 

R7    $C016        Read  AltZP;  bit  7  =  1 
R7    $C011        Read  BankZ;  bit  7  =  0 
R7    $C012        Read  EnLCRAM;  bit  7  =  1 


Legend: 


Read  memory 
Write  memory 


□ 
R 


Inactive  memory 
Read 


R7  =  Read,  ctieck  bit  7 
W    =  Write 


RR  =  Read  twice  in  succession 


Figure  2-9 

Read  and  write  RAM  and  use  first  $D0  banl< 
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Select  memory: 

W      $C008        Turn  off  AltZP 
RR     $C083 


Select  memory: 
W      $C009 
RR     $C083 
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Read  resulting  status: 

R7  $0016  Read  AltZP;  bit  7  =  0 
R7  $C01 1  Read  Bank2;  bit  7  =  1 
R7    $C012         Read  EnLCRAM;  bit  7  =  1 


Read  resulting  status: 

R7    $C016         Read  AltZP;  bit  7  =  1 
R7    $C011        Read  Bank2;  bit  7  =  0 
R7    $C012         Read  EnLCRAM;  bit  7  =  1 


Legend: 


Read  memory  |         |   =   Inactive  memory 

Write  memory  R     =   Read 


R7  =  Read,  check  bit  7 
W    =  Write 


RR  =  Read  twice  in  succession 


Figure  2-10 

Read  and  write  RAM  and  use  second  $D0  bank 


Bank-switched  memory 
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48K  memory 

The  48K  memory  space  (actually,  47. 5K)  extends  from  location 
$0200  to  location  $BFFF  (Figure  2-11)  in  both  main  and  auxiliary 
RAM.  The  amount  of  storage  available  in  this  address  space 
depends  on  what  language  or  operating  system  you  are  using,  and 
what  video  display  needs  your  program  has. 


Page  allocations 

Most  of  the  Apple  He's  48K  RAM  is  available  for  storing  your 
programs  and  data.  However,  a  few  RAM  pages  are  reserved  for  the 
use  of  the  Monitor  firmware,  the  Applesoft  BASIC  interpreter,  and 
whatever  video  display  you  may  select. 


Important     The  system  does  not  prevent  your  using  ttiese  pages,  but  if  you 
do  use  them,  you  must  be  carefui  not  to  disturb  the  system 
data  they  contain. 


A  buffer  is  any  storage  area  set 
aside  for  one  program  or  device 
to  put  information  into  and 
another  to  take  information  out 
of  at  a  different  time  or  rate, 


Page  $02  (the  input  buffer) 

The  GetLn  input  routine  uses  page  $02  as  its  keyboard-input  buffer. 
The  size  of  this  buffer  (256  bytes)  sets  the  maximum  size  of  input 
strings  read  by  Applesoft  or  the  Monitor.  If  you  know  that  you  won't 
be  typing  any  long  input  strings  (more  than,  say,  30  characters), 
you  can  store  temporary  data  at  the  upper  end  of  page  $02. 


i?efer  to  Appendix  D  and  to  the 
appropriate  programmer  and 
reference  manuais  for  operating 
system  use  of  page  $03. 

Global  storage  refers  to  an  area 
reserved  for  information  that 
programs  use  in  common. 
Vectors— the  addresses  of 
speciai  routines— are  exampies 
of  this  l<ind  of  information.  See 
"The  Reset  Routine"  about  the 
giobai  storage  and  vectors 
found  on  page  $03. 


Page  $03  (global  storage  and  vectors) 

The  Monitor  and  operating  systems  use  parts  of  page  $03  for  global 
storage  and  vectors.  Table  2-7,  later  in  this  chapter,  shows  the 
part  of  page  $03  the  built-in  firmware  uses. 


Pages  $04-$07  (text  and  low-resolution  Page  1) 

The  most  often  used  display  buffer  is  the  text  and  low-resolution 
graphics  Page  1  (TLPl  in  Figure  2-11),  which  occupies  main 
memory  pages  $04  through  $07.  It  is  not  usable  for  program  and 
data  storage  if  you  are  using  Monitor  routines  or  Applesoft,  or  with 
almost  any  other  program  that  uses  text  or  low-resolution  display. 


36 


Chapter  2;  Memory  Organization  and  Control 


r 


Bank- 
Switched 
Memory 


ROM/HW 


$FFFF 


V  $D000 
r  $CFFF 


r- 


I 


$cooo 


$BFFF 


$6000 
'^SSFFF 


High- 
Resolution  * 
Pages 


$4000_ 
$3FFF 


v$2000 
$1FFF" 


r  $obff 

Text  and       J    $0800_ 
Low-Resolution  t    $07FF 

P^9^^  U0400_ 

i^  $0200 

{$oiff" 
$0000 


Figure  2- n 

48K  memory  map 
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See  "Port  Screen  Hole  RAM 
Space'  in  Chapter  3. 


Text  and  low-resolution  Page  IX  (TLPIX)  is  an  identical  display 
page  occupying  auxiliary  memory  pages  $04  through  $07.  This  pair 
of  text  and  low-resolution  graphics  pages  are  used  together  to 
produce  80-column  text  display. 

There  are  128  locations  in  pages  $04  through  $07  (.64  in  main  RAM, 
64  in  auxiliary  RAM)  that  are  not  displayed  on  the  screen.  These 
locations  are  called  screen  holes. 


Warning      The  screen  holes  are  reserved  for  use  by  the  built-in  firmware. 


Pages  $08-$0B  (text  and  low-resolution  Page  2) 

The  second  text  and  low-resolution  graphics  display  buffer,  TLP2, 
occupies  main  memory  pages  $08  through  $0B.  Most  programs  do 
not  use  Page  2  for  displays,  but  TLP2  is  there  for  display  use  if 
required. 

Text  and  low-resolution  Page  2X  (TLP2X)  is  an  identical  display 
buffer  occupying  pages  $08  through  $0B  in  auxiliary  memory. 

Note  that  Apple  lie  firmware  does  not  provide  a  way  to  use  the 
second  pair  of  text  and  low-resolution  graphics  pages  for  80- 
column  text  display. 


For  more  on  serial  port  2,  see 
Chapter  8. 


Page  $08  (communication  port  buffers) 

Serial  port  2  uses  the  first  half  of  auxiliary  memory  page  $08 
(addresses  $0800  through  $087F)  as  a  keyboard  input  buffer,  and  the 
second  half  of  the  page  (addresses  $0880  through  $08FF)  as  a  serial 
input  buffer.  These  buffers  increase  the  data  transfer  rates  possible 
with  the  serial  communication  port.  Appendix  E  explains  how  to 
use  these  features.  If  your  program  does  not  use  this  page  for 
buffers,  it  can  use  it  as  part  of  TLP2X. 


See  Chapter  5. 


Pages  $20-$3F  (tiigti-resoiution  Page  1) 

The  primary  high-resolution  graphics  display  buffer,  high- 
resolution  Page  1  (HRPl),  occupies  the  32  memory  pages  from  $20 
through  $3F  Oocations  $2000  through  $3FFF).  If  your  program 
doesn't  use  high-resolution  graphics,  this  area  is  usable  for 
programs  or  data. 

High-resolution  Page  IX  (HRPIX)  is  an  identical  display  page 
occupying  auxiliary  memory  pages  $20  through  $3F. 

The  Apple  lie  can  display  double  high-resolution  graphics  by 
interleaving  HRPl  and  HRPIX. 
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For  more  Information  about  ttie 
display  buffers,  see  CInapter  5. 


Pages  $40-$5F  (high-resolution  Page  2) 

High-resolution  Page  2  occupies  main  memory  pages  $40 
through  $5F  Oocations  $4000  through  $5FFF).  Most  programs  use 
this  area  for  program  or  data  storage,  but  it  is  also  available  as  a 
second  high-resolution  page. 

High-resolution  Page  2X  (HRP2X)  occupies  auxiliary  memory 
pages  $40  through  $5F. 

Apple  lie  firmware  provides  high-resolution  graphics  routines  for 
HRPl  and  HRP2  only.  Refer  to  the  Applesoft  BASIC  Programmer's 
Reference  Manual. 


For  details,  refer  to  "Using 
Display  Memory  Switches.' 


Using  48K  memory  switches 

Two  switches  select  main  or  auxiliary  RAM  in  the  48K  memory 
space:  RAMRd  determines  which  to  use  for  reading,  and  RAMWrt 
determines  which  to  use  for  writing.  When  these  switches  are  on, 
they  select  auxiliary  memory.  When  they  are  off,  they  select  main 
memory.  (This  discussion  assumes  that  the  SOStore  switch,  used  to 
control  display  memory,  is  off.) 

Each  switch  has  three  locations  assigned  to  it  (Table  2-2):  one  to 
turn  it  on,  one  to  turn  it  off,  and  a  third  to  read  its  state.  Because  the 
memory  locations  for  turning  the  switches  on  and  off  are  shared 
with  keyboard  reading  functions,  you  must  write  to  these  addresses 
to  use  them  for  memory  switching.  For  each  switch,  you  can  read 
bit  7  at  its  third  location  to  check  whether  the  switch  is  on  or  off  If 
the  switch  is  on,  bit  7  is  1;  if  the  switch  is  off,  bit  7  is  0. 


Table  2-2 

48K  memory 

■  switches 

Name 

Action 

Hex 

Dec 

Function 

RAMRd 

W 

$C002 

49154 

Off:  Read  main  48K  RAM 

RAMRd 

W 

$C003 

49155 

On:  Read  auxiliary  48K  RAM 

RdRAMRd 

R7 

$C013 

49171 

Read  whether  main  (0)  or 
aux.  (1) 

RAMWrt 

W 

$C004 

49156 

Off:  Write  to  main  48K  RAM 

RAMWrt 

W 

$C005 

49157 

On:  Write  to  auxiliary  48K 
RAM 

RdRAMWrt 

R7 

$C014 

49172 

Read  whether  main  (0)  or 
aux.  (1) 

Note:  SOStore  must  be  off  to  switch  all  memory  in  this  range,  including 
display  memory  (Table  2-6). 

48K  memor/  39 


Select  memory: 
W    $C000 
W    $C002 
W    $C005 

Main  RAM 
I 1 


Turn  off  SOStore 

Read  from  main  memory 

Write  to  auxiliary  memory 

Auxiliary  RAM 

' ' 

r 1 

I 1 1 

I    I    I 
I 1 1 


<HRP2X<; 


^HRP1XS 


^^v. 


.TLP2X 
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Select  memory: 
W    $C0O0 
W    $C003 
W    $C004 

Main  RAM 


Turn  off  SOStore 

Read  from  auxiliary  memory 

Write  to  main  memory 

Auxiliary  RAM 

I 1 

I 1 

I — i — I 


/HRP2X/ 


:;hrpix^ 


:^////.\ 


^^ 


f\ 


I I 


TLP2X 
TLPIX 


Read  resulting  status: 

R7  SC0 18  Read  SOStore;  bit  7  =  0 
R7  $C013  Read  RAMRd;  bit  7  =  0 
R7    $C014        Read  RAMWrt;  bit  7  =  1 


Read  resulting  status: 

R7  $C018  Read  SOStore;  bit  7  =  0 
R7  $C013  Read  RAMRd;  bit7  =  1 
R7    $C014        Read  RAMWrt;  bit  7  =  0 


Legend: 


^  ^  Read  memory 
^  =  Write  memory 


I         I   =  Inactive  memory  R7  =  Read,  check  bit  7 

R     =   Read  W    =  Write 


Figure  2-12 

48K  RAM  selection,  split  pairs 
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Select  memory: 
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Read  resulting  status: 
R7    $C018        Read  SOStore;  bit  7  =  0 
R7    $C013        Read  RAMRd;  bit  7  =  0 
R7    $C014        Read  RAMWrt;  bit  7  =  0 


Select  memory: 
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Read  resulting  status: 

R7  $C018  Read  SOStore;  bit  7  =  0 
R7  $C013  Read  RAMRd;  bit7  =  1 
R7    $C014        Read  RAMWrt;  bit  7  =  1 


Legend: 

=  Read  memory 
=  Write  memory 

=  inactive  memory 
=   Read 

R7 
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=  Read,  check  bit  7 
=  Write 
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Figure  2-13 

48 K  RAM  selection,  one  side  oniy 


48K  memory 
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Transfers  between  main  and  auxiliary  memory 

If  you  want  to  write  assembly-language  programs  that  use  auxiliary 
memory  but  you  don't  want  to  manage  the  auxiliary  memory 
yourself,  you  can  use  the  built-in  48K  RAM  transfer  routines.  These 
routines  Oisted  in  Table  2-3)  make  it  possible  to  move  between 
main  and  auxiliary  memory  without  having  to  manipulate  the  soft 
switches  described  earlier  in  this  chapter. 


Important     The  routines  described  below  mal<e  it  easier  to  use  auxiliary 

memory,  but  they  do  not  protect  you  from  errors.  You  stiii  have 
to  pian  your  use  of  auxiliary  memory  to  avoid  catastrophic 
effects  on  your  program. 


Table  2-3 

48K  RAM  transfer  routines 


Name 


Action       Hex 


Function 


MoveAux       JSR  $C3n 

XFer  JMP  $C314 


Move  data  blocks  between  main 
and  auxiliary  48K  memory. 

Transfer  program  control  between 
main  and  auxiliary  48K  memory. 


Transferring  data 

In  your  assembly-language  programs,  you  can  use  the  built-in 
routine  named  MoveAux  to  copy  blocks  of  data  from  main  memory 
to  auxiliary  memory  or  from  auxiliary  memory  to  main  memory. 
Before  calling  this  routine,  you  must  put  the  data  addresses  into 
byte  pairs  in  page  $00  and  set  or  clear  the  carry  bit  to  select  the 
direction  of  the  move. 


Warning      Don't  try  to  use  MoveAux  to  copy  data  In  bank-sv\/itched 
memory  (page  $00,  page  $01 ,  or  pages  $D0  through  $FF), 
MoveAux  uses  page  $00  all  during  the  copy. 

The  pairs  of  bytes  you  use  for  passing  addresses  to  this  routine  are 
called  Al,  A2,  and  A4,  and  they  are  used  for  parameter  passing  by 
several  of  the  Apple  He's  built-in  routines.  The  addresses  of  these 
byte  pairs  are  shown  in  Table  2-4. 

Put  the  addresses  of  the  first  and  last  bytes  of  the  block  of  memory 
you  want  to  copy  into  Al  and  A2.  Put  the  starting  address  of  the 
block  of  memory  you  want  to  copy  the  data  to  into  A4. 
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Table  2-4 

Parameters  for  MoveAux  routine 


Name       Location         Parameter  passed 


Carry 


AIL 

$3C 

AlH 

$3D 

A2L 

$3E 

A2H 

$3F 

A4L 

$42 

A4H 

$43 

X,  Y, 

A 

1  =  Move  from  main  to  auxiliary  memory. 
0  =  Move  from  auxiliary  to  toain  memory. 
Source  starting  address,  low-order  byte. 
Source  starting  address,  high-order  byte. 
Source  ending  address,  low-order  byte. 
Source  ending  address,  high-order  byte. 
Destination  starting  address,  low-order  byte. 
Destination  starting  address,  high-order  byte. 
These  registers  are  preserved. 


The  MoveAux  routine  uses  the  carry  bit  to  select  the  direction  to 
copy  the  data.  To  copy  data  from  main  memory  to  auxiliary 
memory,  set  the  carry  bit  (SEC  instruction);  to  copy  data  from 
auxiliary  memory  to  main  memory,  dear  the  carry  bit 
(CLC  instruction). 

When  you  make  the  subroutine  call  to  MoveAux,  the  subroutine 
copies  the  block  of  data  as  specified  by  the  A  register  and  the  carry 
bit.  When  it  is  finished,  the  accumulator  and  the  X  and  Y  registers 
are  just  as  they  were  when  you  called  it. 


Transferring  control 

You  can  use  the  built-in  routine  named  XFer  to  transfer  control  to 
and  from  program  segments  in  auxiliary  memory.  You  must  set  up 
three  parameters  before  using  XFer:  the  address  of  the  routine  you 
are  transferring  to,  the  direction  of  the  transfer,  and  which  page  $00 
and  stack  you  want  to  use  (Table  2-5). 


Table  2-5 

Parameters  for  XFer  routine 


Name 


Location      Parameter  passed 


Carry 


Overflow 


$03ED 
$03EE 
X,  Y,  A 


1  =  Transfer  from  main  to  auxiliary  memory. 

0  =  Transfer  from  auxiliary  to  main  memory. 

1  =  Use  page  $00  and  stack  in  auxiliary 
memory. 

0  =  Use  page  $00  and  stack  in  main  memory. 
Program  starting  address,  low-order  byte. 
Program  starting  address,  high-order  byte. 
These  registers  are  preserved. 


48K  memory 
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Put  the  transfer  address  into  the  two  bytes  at  locations  $03ED 
and  $03EE,  with  the  low-order  byte  first,  as  usual.  The  direction  of 
the  transfer  is  controlled  by  the  carry  bit:  set  the  carry  bit  to  transfer 
to  a  program  in  auxiliary  memory;  clear  the  carry  bit  to  transfer  to  a 
program  in  main  memory. 

Use  the  overflow  bit  to  select  which  page  $00  and  stack  you  want  to 
use:  clear  the  overflow  bit  to  use  the  main  memory;  set  the  overflow 
bit  (cause  an  overflow  condition)  to  use  the  auxiliary  memory. 

After  you  have  set  up  the  parameters,  pass  control  to  the  XFer 
routine  by  a  jump  instruction,  rather  than  a  subroutine  call. 


Warning      It  is  your  responsibility  as  the  programmer  to  save  the  current 
stack  pointer  before  using  XFer  and  to  restore  it  after  regaining 
control.  Failure  to  do  so  will  cause  program  errors.  Refer  to 
Appendix  E  for  Instructions  on  how  to  do  this. 


Using  display  memory  switches 

Selection  of  main  or  auxiliary  RAM  for  the  48K  memory  space  is 
described  earlier  in  this  chapter.  However,  under  many 
circumstances  your  program  may  want  to  control  reading  and 
writing  to  display  pages  separately.  The  switches  discussed  in  this 
section  override  the  effects  of  RAMRd  and  RAMWrt  for  display 
pages  only. 

Three  switches  are  involved  in  the  display  page  selection  process. 
Each  of  them  has  three  locations  assigned  to  it:  one  to  turn  it  on, 
one  to  turn  it  off,  and  a  third  to  read  its  state  (Table  2-6).  One  of  the 
switches,  SOStore,  shares  its  on  and  off  addresses  with  a  keyboard 
reading  function.  As  a  result,  your  program  must  write  to  these 
locations  to  turn  the  switch  on  and  off. 
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Table  2-6 

Display  memory  switches 


Name 


Action       Hex 


Dec 


Function 


SOStore  W 


SOStore  W 


RdSOStore       R7 
Page2  R 

Page2  R 


RdPage2  R7 

HiRes  R 


HiRes 


R 


RdHiRes  R7 

lOUDis  W 

lOUDis  W 


$C000      49152 


$C001      49153 


$C018  49176 
$C054  49236 
$C055      49237 


$C01C  49180 

$C056  49238 

$C057  49239 

$C01D  49181 

$C07E  49278 

$C07F  49279 


Off:  RAMRd  and 
RAMWrt  determine  RAM 
locations. 

On:  Page2  switcties 
between  TLPl  and 
TLPIX,  and  Of  HiRes  on) 
between  HRPl  and 
HRPIX. 

Read  whether  80Store 
on  CD  or  off  CO). 

Off:  Select  TLPl  and 
HRPl. 

On:  If  80Store  off,  switch 
to  TLP2,  and  Cif  HiRes 
on)  to  HRP2.  If  80Store 
on,  switch  to  TLPIX,  and 
Cif  HiRes  on)  to  HRPIX. 

Read  whether  Page2 
on  CD  or  off  CO). 

Off:  Display  text  and 
low-resolution  page. 

On:  Display  high- 
resolution  pages;  make 
Page2  switch  between 
high-resolution  pages. 

Read  whether  HiRes 
on  CD  or  off  CO). 

On:  Disable  lOU  access 
for  addresses$C058  to 
$C05F;  enable  access  to 
DHiRes  switch*. 

Off:  Enable  lOU  access 
for  addresses  $C058  to 
$C05F;  disable  access  to 
DHiRes  switch*. 


48K  memory 
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Table  2-6  (continued) 
Display  memory  switches 


Name 


Action       Hex 


Dec 


Function 


RdlOUDis       R7 


DHiRes 


DHiRes 


R/W 


$C07E     49278 
$C05E     49246 


R/W         $C05F     49247 


RdDHiRes       R7 


$C07F     49279 


Read  lOUDis  switch 
-a=ofOt 

On:  (If  lOUDis  on)  turn 
on  double  high- 
resolution. 

Off:  (If  lOUDis  on)  turn 
off  double  high- 
resolution. 

Read  DHiRes  switch 
(l=on)t. 


*  The  firmware  normally  leaves  lOUDis  on. 

t  Reading  or  writing  any  address  in  the  range  $CO70-$CO7F  also  triggers 
the  paddle  timer  and  resets  VBlInt  (see  Chapter  9). 

For  each  switch,  you  can  read  bit  7  at  its  third  location  to  check 
whether  the  switch  is  on  or  off.  If  the  switch  is  on,  bit  7  is  1;  if  the 
switch  is  off,  bit  7  is  0. 

Here  is  how  these  switches  work  for  reading  and  writing: 

n  If  HiRes  is  off,  then  Page2  switches  between  text  and  low- 
resolution  graphics  pages  (TLP)  only.  If  HiRes  is  on,  then  Page2 
switches  between  TLP  and  high-resolution  graphics  pages  (HRP). 

n  If  SOStore  is  off,  RAMRd  and  RAMWrt  (Table  2-2)  determine 
whether  main  or  auxiliary  RAM  locations  are  used.  Page2  selects 
pages  for  display  (Chapter  5),  but  not  for  reading  and  writing. 

n  If  SOStore  is  on,  it  overrides  RAMRd  and  RAMWrt  with  respect  to 
the  display  pages  selected  by  HiRes  and  Page2  (Figures  2-14 
and  2-15). 
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The  reset  routine 

A  procedure  called  the  reset  routine  (Figure  2-1 6)  puts  the  Apple  lie 
into  a  known  state  when  it  has  just  been  turned  on  or  when  you  hold 
down  Control  while  pressing  Reset.  The  reset  routine  puts  the 
Apple  lie  into  its  normal  operating  mode  and  restarts  the  program 
indicated  at  locations  $03F2  and  $03F3  (Table  2-7). 

When  you  initiate  a  reset,  hardware  in  the  Apple  He  sets  the 
memory-controlling  soft  switches  to  normal:  main  ROM  and  RAM 
are  enabled,  auxiliary  RAM  is  disabled  and  the  bank-switched 
memory  space  is  set  up  to  read  from  ROM  and  write  to  RAM,  using 
the  second  bank  at  $D000. 


c 


Power  On 
{Cold  Start) 
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-  Read/write  main  48K  RAM 

-  Read  ROM.  write  main  bank- 
switched  RAM,  use  bank  2 

-  Display  40-column  text  page  $01 , 
primary  character  set,  normal 
format,  cursor  at  bottom  left 

-  Enable  access  to  DHiRes  switch 

-  I/O  links:  keyboard  input  (KSW), 
display  output  (CSW) 

-  Ports:  startup  settings 

-  Clear  keyboard  strobe 

-  Sound  the  speaker 


Write  trash  in  one  location 

per  memory  page  (including 

power-up  validity  byle| 


Restart  program  with 
variables  intact 


Restart  Applesoft 
or  Integer  BASIC 


says  to  do 


Clear  screen;  display 

Apple  I  Ic,  load  reset 

vector  and  power-up  byte; 

initiate  disk  startup 

firmware 


Figure  2-16 

Reset  routine  flovi/chart 


The  reset  routine 
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Table  2-7 

Page  $03  vectors 


The  reset  vector  validity  check 
is  described  under  "The  Reset 
Vector.' 


Vector  address       Vector  function 


$03F0  (1008) 
$03F1  (1009) 

$03F2  (1010) 

$03F4  (1012) 

$03F5  (1013) 
$03F6  (1014) 

$03F7  (1015) 

$03F8  (1016) 
$03F9  (1017) 
$03FA  (1018) 

$03FB  (1019) 
$03FC  (1020) 
$03FD  (1021) 

$03FE  (1022) 
$03FF  (1023) 


Address  of  the  subroutine  ttiat  handles  BRK 
requests  (normally  $59,  $FA) 

Reset  vector  (see  text)  $03F3  (1011) 

Power-up  byte  (see  text) 

Jump  instruction  to  the  subroutine  that  handles 
Applesoft  and  commands  (normally 
$4C,$58,$FF) 


Jump  instruction  to  the  subroutine  that  handles 
user  Control-Y  commands 


Jump  instruction  to  the  subroutine  that  handles 
nonmaskable  interrupts  (not  used  on  Apple  lie) 

Interrupt  vector  (address  of  the  subroutine  that 
handles  interrupt  requests)  (Appendix  E) 


The  reset  routine  sets  the  display-controlling  soft  switches  to  display 
40-column  text  Page  1  using  the  primary  character  set,  then  sets  the 
display  window  equal  to  the  full  40-column  display,  puts  the  cursor 
at  the  bottom  of  the  screen,  and  sets  the  text  display  format  to 
normal. 

The  reset  routine  also  sets  the  keyboard  and  display  as  the  standard 
input  and  output  devices  (Chapter  3).  It  masks  mouse  interrupts  and 
sets  mouse  defaults  (Table  9-1).  Finally,  it  enables  DHiRes  switch 
access  (by  turning  on  lOUDis),  clears  the  keyboard  strobe,  and 
sounds  the  speaker. 

The  Apple  lie  has  three  types  of  reset:  power-on  reset,  also  called 
cold-start  reset;  warm-start  reset;  and  forced  cold-start  reset.  The 
procedure  descrit)ed  above  is  the  same  for  any  type  of  reset.  What 
happens  next  depends  on  the  reset  vector.  The  reset  routine  checks 
the  reset  vector  to  determine  whether  it  is  valid  or  not.  If  the  reset 
was  caused  by  turning  the  power  on,  the  vector  will  not  be  valid,  and 
the  reset  routine  will  perform  the  cold-start  procedure.  If  the  vector 
is  valid,  the  routine  will  perform  the  warm-start  procedure. 


50 


Chapter  2:  Memor/  Organization  and  Control 


The  cold-start  procedure  (power  on) 

If  the  reset  vector  is  not  valid,  either  the  Apple  lie  has  just  been 
turned  on  or  something  has  caused  memory  contents  to  be 
changed.  The  reset  routine  clears  the  display  and  puts  the  string 
Apple©   lie  at  the  top  of  the  display.  It  loads  the  reset  vector  and 
the  validity-check  byte,  then  initiates  the  startup  routine  that  resides 
in  the  disk  controller  firmware.  The  bootstrap  routine  then  loads 
whatever  operating  system  resides  on  the  disk  in  the  built-in  drive. 
When  the  operating  system  has  been  loaded,  it  displays  other 
messages  on  the  screen.  If  there  is  no  disk  in  the  disk  drive,  the  drive 
motor  keeps  spinning  for  a  brief  time.  Then  the  firmware  shuts  it  off 
and  displays  the  message  Check  Disk  Drive  at  the  bottom  of  the 
screen. 

If  you  press  Control-Reset  again  before  the  startup  procedure  is 
completed,  the  reset  routine  continues  without  using  the  disk,  and 
passes  control  to  the  Applesoft  BASIC  interpreter. 


The  warm-start  procedure  (Control-Reset) 

whenever  you  press  Control-Reset  when  the  Apple  lie  has  already 
completed  a  cold-start  reset,  the  reset  vector  is  still  valid  and  it  is 
not  necessary  to  reinitialize  the  entire  system.  The  reset  routine 
simply  uses  the  vector  to  transfer  control  to  the  program  it  points 
to,  which  at  power-up  is  the  Applesoft  interpreter. 

If  the  vector  does  point  to  the  Applesoft  interpreter,  your  Applesoft 
program  and  variables  are  still  intact.  If  you  are  using  DOS  or 
ProDOS,  that  operating  system  is  the  resident  program  and  it 
restarts  the  BASIC  interpreter  you  were  using  when  you  pressed 
Control-Reset. 


Important     A  program  residing  oniy  in  bank-switclied  RAM  cannot  use  tiie 
reset  vector  to  regain  controi  after  a  reset,  because  upon  reset 
tine  hardware  selects  the  ROM  for  reading  in  the  bank-switched 
memory  space. 
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Forced  cold  start  (Open  Apple-Control-Reset) 

If  a  program  has  set  the  reset  vector  to  point  to  its  own  warm-start 
address,  as  described  below,  pressing  Control-Reset  causes  transfer 
of  control  to  that  program.  If  you  want  to  stop  such  a  program 
without  turning  the  power  off  and  on,  you  can  force  a  cold-start 
reset  by  holding  down  Control  and  Open  Apple,  then  pressing  and 
releasing  Reset. 


Important     When  you  want  to  stop  a  program  unconditionally— for 
example,  to  start  up  the  Apple  He  withi  some  otlier 
program— you  should  use  the  forced  cold-start  reset.  Open 
Apple-Control-Reset,  instead  of  turning  the  power  off  and  on. 


UniDisk  3.5     You  must  hold  Open  Apple  down  until  the  built-in  drive  starts 
to  spin.  If  you  release  Open  Apple  before  the  drive  starts  to 
spin,  the  Apple  lie  drops  Into  BASIC  instead  of  rebooting. 

The  forced  cold-start  reset  works  as  follows.  First,  it  destroys  the 
program  or  data  in  memory  by  writing  two  bytes  of  arbitrary  data 
into  each  page  of  main  RAM.  The  two  bytes  that  get  written  over  in 
page  $03  are  the  ones  that  contain  the  reset  vector.  The  warm-start 
reset  routine  finds  the  error,  and  so  performs  a  normal  cold-start 
reset. 

Note  that  if  you  press  both  Open  Apple  and  Solid  Apple  during 
power-up  or  Control-Reset,  built-in  exercise  code  is  executed.  This 
code  is  for  production  and  has  no  end-user  value. 


Ihe  reset  vector 

The  cold-start  reset  routine  stores  the  starting  address  of  the  built-in 
Applesoft  interpreter,  low-order  byte  first,  in  the  reset  vector 
address  at  locations  $03F2  and  $03F3.  It  then  stores  a  validity-check 
byte,  also  called  the  power-up  byte,  at  location  $03F4.  The  validity- 
check  byte  is  computed  by  performing  an  exclusive-OR  of  the 
second  byte  of  the  vector  with  the  constant  l65  (hexadecimal  $A5). 
Each  time  you  reset  the  Apple  lie,  the  reset  routine  uses  this  byte  to 
determine  whether  the  reset  vector  is  still  valid. 
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You  can  change  the  reset  vector  so  that  the  reset  routine  will  transfer 
control  to  your  program  instead  of  to  the  Applesoft  interpreter.  For 
this  to  work,  you  must  also  change  the  validity-check  byte  to  the 
exclusive-OR  of  the  high-order  byte  of  your  new  reset  vector  with 
the  constant  l65  ($A5).  If  you  fail  to  do  this,  then  the  next  time  you 
reset  the  Apple  lie,  the  reset  routine  will  determine  that  the  reset 
vector  is  invalid  and  perform  a  cold-start  reset,  eventually 
transferring  control  to  the  disk  bootstrap  routine  or  to  Applesoft. 

There  is  a  subroutine  that  generates  the  validity-check  byte  for  the 
current  reset  vector.  This  subroutine,  called  SetPWRC,  is  at 
location  $FB6F.  When  your  program  finishes,  it  can  return  the 
Apple  lie  to  normal  operation  by  restoring  the  original  reset  vector 
and  again  calling  the  subroutine  to  fix  up  the  validity-check  byte. 
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Chapter  3 

Introduction 
to  Apple  lie  I/O 
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This  chapter  is  an  introduction  to  the  built-in  I/O  capabilities  of  the 
Apple  lie.  It  outlines 

D  standard  I/O  links  and  their  functions 

D  I/O  firmware  protocols 

n  dedicated  memory  storage  locations 

n  direct  I/O 

The  next  six  chapters  discuss  these  capabilities  in  detail. 


The  standard  I/O  links 

You  can  use  some  of  the  routines  in  the  Apple  He's  firmware  for 
your  own  programs.  This  can  save  you  both  program  space  and  the 
time  and  effort  of  writing  all  your  own  I/O  routines. 

To  use  the  built-in  firmware  routines,  your  program  must  perform  a 
JSR  to  the  routine's  entry  address.  The  called  routine  then  performs 
an  indirect  jump  through  an  address  stored  somewhere  in  RAM  and 
begins  executing.  When  the  routine  has  finished  doing  its  work,  it 
returns  (with  an  RTS)  to  your  program  at  the  first  instruction 
following  the  JSR  used  to  call  the  routine.  Memory  locations  used 
for  transferring  control  to  other  subroutines,  such  as  the  indirect 
jump's  address  used  by  the  character  I/O  routine,  are  sometimes 
called  vectors.  In  this  manual,  the  locations  used  for  transferring 
control  to  the  Apple  He's  I/O  subroutines  are  called  the  I/O  links. 

In  an  Apple  lie  running  without  an  operating  system,  each  I/O  link 
normally  contains  the  address  of  the  standard  input  or  output 
subroutine.  An  operating  system  will  typically  place  addresses  of  its 
own  I/O  routines  in  these  link  locations  instead. 

By  calling  the  I/O  subroutines  that  then  jump  to  the  routines 
pointed  to  by  the  link  addresses  instead  of  calling  the  standard 
subroutines  direcdy,  you  ensure  that  your  program  will  work 
properly  with  other  software,  such  as  the  operating  system  or  a 
device  driver.  The  I/O  links  contain  the  addresses  of  Keyin  and 
COutl  if  the  enhanced  video  firmware  is  off  (when  the  display  shows 
a  flashing  checkerboard  cursor),  and  of  C3KeyIn  and  C3COutl  if 
that  firmware  is  on  (when  the  display  shows  an  inverse  solid  cursor). 

The  standard  I/O  links  are  two  pairs  of  locations  in  the  Apple  lie 
RAM  in  the  range  $36  through  $39  that  are  used  for  controlling 
character  input  and  output. 

♦  Note:  Not  all  operating  systems  use  the  standard  I/O  links.  For 
example,  Apple  Pascal  does  not  use  them. 
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The  link  at  locations  $36  and  $37  is  called  CSW (character  output 
switch).  Individually,  location  $36  is  called  CSWL  (CSW  low)  and 
location  $37  is  called  CSWHQZSW  high).  This  link  holds  the 
starting  address  of  the  subroutine  the  Apple  lie  is  currently  using  for 
single-character  output.  This  address  is  normally  $FDFO,  the 
address  of  routine  COutl. 

The  Monitor  Is  discussed  In  When  you  issue  either  a  PR#n  from  BASIC  or  an  n  Control-P  from 

Chapter  10,  ^j^g  Monitor,  the  Apple  lie  changes  this  link  address  to  the  first 

address  in  the  ROM  space  allocated  to  port  n.  That  address  has  the 
form  $CnOO.  Subsequent  calls  for  character  output  are  thus 
transferred  to  the  firmware  starting  at  that  address.  When  it  has 
finished,  the  firmware  executes  an  RTS  (return  from  subroutine) 
instruction  to  return  control  to  the  calling  program.  Sometimes  a 
PR#n  will  cause  both  input  and  output  switches  to  be  changed  (as  in 
the  80-column  firmware). 

A  similar  link  at  locations  $38  and  $39  is  called  /TS'W"  (keyboard 
input  switch).  Individually,  location  $38  is  called  KSWL  (KSW  low) 
and  location  $39  is  called  KSWHQf^SW  high).  This  link  holds  the 
starting  address  of  the  routine  currently  being  used  for  single- 
character  input — normally  $FD1B,  the  starting  address  of  the 
standard  input  routine  Keyln. 

When  you  issue  an  IN#n  command  from  BASIC  or  an  n  Control-K 
from  the  Monitor,  the  Apple  lie  changes  the  link  address  in  KSW  to 
$CnOO,  the  beginning  of  an  I/O  firmware  subroutine.  Subsequent 
calls  for  character  input  are  thus  transferred  to  that  firmware.  The 
firmware  puts  the  input  character,  with  its  high  bit  set,  into  the 
accumulator  and  executes  an  RTS  (return  from  subroutine) 
instruction  to  return  control  to  the  program  that  requested  input. 

When  a  disk  operating  system  (EXDS  or  ProDOS)  is  running,  one  or 
both  of  the  standard  I/O  links  hold  addresses  of  the  disk  operating 
system's  input  and  output  routines.  The  operating  system  has 
internal  locations  that  hold  the  addresses  of  the  currently  active 
character  input  and  output  routines. 


Warning      If  a  program  that  Is  running  with  DOS  or  ProDOS  changes  the 
standard  iink  addresses,  either  directly  or  via  iN#  and  PR# 
commands,  the  operating  system  may  be  disconnected  from 
the  system.  To  avoid  this  problem,  when  programming  in  BASIC 
you  should  always  issue  an  empty  PRINT  statement  (to  be  sure 
that  what  follows  begins  a  new  line)  before  issuing  the  PRINT 
statement  containing  Controi-D  and  the  IN#  or  PR#  command. 
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Refer  to  the  section  on  input 
and  output  link  addresses  In  the 
operating  system  manuals  for 
further  details. 


After  changing  either  CSW  or  KSW,  your  assembly-language 
programs  running  under  DOS  should  call  the  subroutine  at 
location  $03EA.  This  subroutine  transfers  the  link  address  to  a 
location  inside  the  operating  system  and  then  restores  the 
operating  system  link  address  in  the  standard  link  location. 


GetLn  also  provides  on-screen 
editing  features.  See  'Editing 
With  GetLn.- 


Standard  input  features 

The  Apple  He's  firmware  includes  two  different  subroutines  for 
reading  from  the  keyboard,  RdKey  (read  key)  and  GetLn  (get  line). 

RdKey  calls  the  current  character  input  routine  (that  is,  the  one 
whose  address  is  stored  at  KSW).  This  is  normally  Keyin  or 
C3KeyIn,  which  accepts  one  character  from  the  keyboard.  GetLn 
accepts  a  sequence  of  characters  terminated  with  a  carriage  return. 
Thus  GetLn  allows  line-oriented  input  using  the  current  input 
routine. 


RdKey  subroutine 

A  program  can  get  a  character  from  the  keyboard  by  making  a 
subroutine  call  to  RdKey  at  memory  location  $FDOC.  RdKey  passes 
control  via  the  input  link  KSW  to  the  current  input  subroutine, 
which  is  normally  Keyln. 

RdKey  displays  a  cursor  at  the  current  cursor  position,  which  is 
immediately  to  the  right  of  whatever  character  you  last  sent  to  the 
display  (normally  by  using  the  COut  routine,  described  below). 


Keyln  subroutine 

KeyIn  is  the  standard  input  subroutine.  Wlien  your  program  calls  it, 
Keyln  displays  a  cursor,  waits  until  someone  presses  a  key,  then 
inserts  the  ASCII  code  of  the  key  just  pressed  in  the  accumulator  and 
returns  to  the  calling  program. 

If  the  enhanced  video  firmware  is  inactive,  Keyln  displays  a  cursor 
by  alternately  storing  a  checkerboard  block  in  the  cursor  location, 
storing  the  original  character,  then  storing  the  checkerboard  again. 
If  the  firmware  is  active,  C3KeyIn  places  a  block  cursor  on  the 
screen  by  inverting  (swapping  black  for  white)  the  character  at  the 
cursor  position. 


58 


Chapter  3:  Introduction  to  Apple  He  I/O 


Keyin  ako  generates  a  random  number.  While  it  is  waiting  for  the 
user  to  press  a  key,  KeyIn  repeatedly  increments  the  l6-bit  number 
in  memory  locations  $4E  and  $4F.  This  number  keeps  increasing 
from  0  to  $FFFF  (65535),  then  starts  over  again  at  0.  The  value  of 
this  number  changes  so  rapidly  that  it  is  very  difRcult  to  predict  what 
it  will  be  after  a  key  is  pressed.  A  program  that  reads  from  the 
keyboard  can  use  this  value  as  a  random  number  or  as  a  seed  for  a 
pseudo-random  number  routine. 


GetLn  subroutine 

Programs  often  need  strings  of  characters  as  input.  While  you  could 
call  RdKey  repeatedly  to  get  several  characters  from  the  keyboard, 
there  is  an  easier  way  to  do  it  The  routine  that  you  want  to  use  in  this 
case  is  named  GetLn,  and  it  starts  at  location  $FD6A.  Using  repeated 
calls  to  RdKey,  GetLn  accepts  characters  from  the  standard  input 
subroutine — usually  KeyIn — and  puts  them  into  the  input  buffer 
located  in  the  memory  page  from  $0200  to  $02FF.  GetLn  also 
provides  you  with  some  basic  on-screen  editing  and  control 
features. 

The  first  thing  GetLn  does  when  you  call  it  is  to  display  a  prompt 
The  prompt  indicates  to  the  user  that  the  program  is  waiting  for 
input.  Different  programs  use  different  prompt  characters,  helping 
to  remind  the  user  which  program  is  requesting  the  input.  Table  3-1 
shows  the  prompt  characters  xosed  by  different  programs  on  the 
Apple  lie. 

GetLn  uses  the  character  stored  at  memory  location  $33  as  the 
prompt  character.  In  an  assembly-language  program,  you  can 
change  the  prompt  to  any  character  you  wish.  In  BASIC,  changing 
the  prompt  character  has  no  effect  because  both  BASIC  interpreters 
and  the  Monitor  restore  it  each  time  they  request  input  from  the 
user. 

Table  3-1 

Prompt  characters 

Prompt 

character        Program  requesting  Input 

?  User's  BASIC  program  0NPUT  statement) 

]  Applesoft  BASIC  (Appendix  D) 

>  Integer  BASIC  (Appendix  D) 

*  Firmware  Monitor  (Chapter  10) 

♦  Note:  Applesoft  uses  GetLnl  ($FD6f)  when  a  program  is 
executing.  GetLnl  does  not  print  a  prompt. 
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As  the  user  types  each  character,  GetLn  sends  the  character  to  the 
standard  output  routine — normally  COutl — ^which  displays  it  at  the 
current  cursor  position  and  then  advances  the  cursor  to  indicate  the 
next  character  position.  Control  characters  echoed  by  GetLn  are 
not  executed. 

GetLn  stores  the  characters  in  its  buffer,  starting  at  memory 
location  $0200  and  using  the  X  register  to  index  the  buffer.  GetLn 
continues  to  accept  and  display  characters  until  the  user  presses 
Return  (or  Control-X  to  cancel  the  line).  Then  it  clears  the 
remainder  of  the  line  the  cursor  is  on,  stores  the  carriage-return 
code  to  mark  the  end  of  the  buffer,  places  the  cursor  at  the 
beginning  of  the  next  line,  and  returns. 

The  maximum  line-length  that  GetLn  can  handle  is  255  characters. 
If  the  user  types  more  than  this,  GetLn  sends  a  backslash  (\)  and  a 
carriage  return  to  the  display,  cancels  the  line  it  has  accepted  so  far, 
and  starts  over.  To  warn  the  user  that  the  line  is  getting  full,  GetLn 
sounds  a  bell  (tone)  at  every  keypress  after  the  248th. 

♦  Note:  The  Applesoft  interpreter  accepts  only  239  characters. 


Escape  codes  with  GetLn 

GetLn  has  many  special  functions  that  you  invoke  by  typing  escape 
codes  on  the  keyboard.  An  escape  code  is  sent  by  pressing  Escape, 
releasing  it,  and  then  pressing  some  other  key,  as  shown  in 
Table  3-2. 


Important     Be  sure  to  release  Escape  right  away.  If  you  hiold  It  too  long, 
the  auto-repeat  mechanism  begins,  which  may  cancel  the 
Escape, 
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Table  3-2 

Escape  codes  with  GetLn 


Escape  code  Function 


Escape  Clears  the  window  and  homes  the  cursor 

(places  it  in  the  upper-left  corner  of 
the  screen);  exits  from  escape  mode 

Escape  A  Moves  the  cursor  right  one  line;  exits 

or  Escape  a  from  escape  mode 

Escape  B  Moves  the  cursor  left  one  line;  exits 

or  Escape  b  from  escape  mode 

Escape  C  Moves  the  cursor  down  one  line;  exits 

or  Escape  c  from  escape  mode 

Escape  D  Moves  the  cursor  up  one  line;  exits  from 

or  Escape  d  escape  mode 

Escape  E  Clears  to  the  end  of  the  line;  exits  from 

or  Escape  e  escape  mode 

Escape  F  Clears  to  the  bottom  of  the  window;  exits 

or  Escape  f  from  escape  mode 

Escape  I  Moves  the  cursor  up  one  line;  remains  in 

or  Escape  i  escape  mode 

or  Escape  Up  Arrow 

Escape  J  Moves  the  cursor  left  one  space;  remains 

or  Escape  j  in  escape  mode* 

or  Escape  Left  Arrow 

Escape  K  Moves  the  cursor  right  one  space; 

or  Escape  k  remains  in  escape  mode* 

or  Escape  Right  Arrow 

Escape  M  Moves  the  cursor  down  one  line; 

or  Escape  m  remains  in  escape  mode* 

or  Escape  Down  Arrow 

Escape  4  Switches  to  40-column  mode;  sets  links  to 

C3KeyIn  and  C3COutl;  restores  normal 
window  size  (Table  3-5);  exits  from 
escape  modef 
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Table  3-2  (continued) 
Escape  codes  with  GetLn 


Escape  code  Function 


Escape  8  Switches  to  80-column  mode;  sets  links 

to  C3KeyIn  and  C3COutl;  restores 
normal  window  si2e  CTable  3-5);  exits 
from  escape  model 

Escape  Control-D  Disables  control  characters;  only 

carriage  return,  linefeed,  bell,  and 
backspace  have  an  effect  when  printed 

Escape  Control-E  Reactivates  control  characters 

Escape  Control-Q  Deactivates  the  enhanced  video 

firmware;  sets  links  to  Keyin  and  COutl; 
restores  normal  window  size  (Table  3-5); 
exits  from  escape  modef 

•  Cursor-control  key:  see  text. 

t  This  code  functions  only  when  the  enhanced  video  firmware  is  active. 

In  escape  mode,  you  can  keep  using  the  arrow  keys  and  the  cursor 
movement  keys  I,  J,  K,  and  M  without  pressing  Escape  again.  This 
enables  you  to  perform  repeated  cursor  moves  by  holding  down  the 
appropriate  key. 

When  GetLn  is  in  escape  mode,  it  displays  an  inverse  plus  sign  as 
the  cursor.  You  leave  escape  mode  by  typing  any  key  other  than  a 
cursor  movement  key. 

♦  Note:  The  escape  codes  with  the  arrow  keys  are  the  standard 
cursor  movement  keys  on  the  Apple  lie.  The  escape  codes  with 
I,  J,  K,  and  M  are  the  standard  cursor  movement  keys  on  the 
Apple  II  and  II  Plus,  and  are  present  on  the  Apple  lie  for 
compatibility. 

Escape  sequences  can  be  used  in  the  middle  of  an  input  line  to 
change  the  appearance  of  the  screen.  They  have  no  effect  on  the 
input  line. 
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For  an  Introduction  to  editing 
witin  tl^ese  features,  refer  to  tl^e 
Applesoft  Tutorial. 


Editing  wim  GetLn 

Subroutine  GetLn  provides  the  standard  on-screen  editing  features 
used  by  the  BASIC  interpreters  and  the  Monitor.  Any  program  that 
uses  GetLn  for  reading  the  keyboard  has  these  features. 


Cancel  line 

Any  time  you  are  typing  a  line,  pressing  Control-X  causes  GetLn  to 
cancel  the  line.  GetLn  displays  a  backslash  (\)  and  issues  a  carriage 
return,  then  displays  the  prompt  and  waits  for  you  to  type  a  new 
line.  GetLn  takes  the  same  action  when  you  type  more  than 
255  characters,  as  desaibed  above. 


Backspace 

When  you  press  Left  Arrow  (or  Control-H),  GetLn  moves  its  buffer 
pointer  back  one  space,  effectively  deleting  the  last  character  in  its 
buffer.  It  also  sends  a  backspace  character  to  routine  COut,  which 
moves  the  cursor  back  one  space.  If  you  type  another  character 
now,  it  replaces  the  character  you  backspaced  over,  both  on  the 
display  and  in  the  line  buffer. 

Each  time  you  press  Left  Arrow,  it  moves  the  cursor  left  and  deletes 
another  character,  until  you  are  back  at  the  beginning  of  the  line.  If 
you  then  press  Left  Arrow  one  more  time,  you  have  effectively 
canceled  the  line,  and  GetLn  issues  a  carriage  return  and  displays 
the  prompt.  The  cursor  moves  even  if  the  deleted  character  is  an 
invisible  control  character.  Thus  it  is  possible  for  screen  alignment 
and  buffer  alignment  to  be  different. 


See  'Escape  Codes  With 
GetLn.' 


Retype 

Right  Arrow  (or  Control-U)  has  a  function  that  is  complementary  to 
the  backspace  function.  When  you  press  Right  Arrow,  GetLn  picks 
up  the  character  under  the  cursor  just  as  if  it  had  been  typed  on  the 
keyboard.  You  can  use  this  procedure  to  pick  up  characters  that  you 
just  deleted  by  backspacing  across  them.  You  can  use  the  backspace 
and  retype  functions  with  the  cursor-motion  functions  to  edit  data 
on  the  display. 
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standard  output  features 

The  standard  output  routine  is  named  COut  (character  output).  COut 
normally  calls  COutl  or  C3COutl,  which  sends  one  character  to  the 
display,  advances  the  cursor  position,  and  scrolls  the  display  when 
necessary.  COutl  and  C3COutl  restrict  their  use  of  the  display  to  an 
active  area  called  the  text  window,  described  later  in  this  chapter. 


COut  subroutine 

Your  program  makes  a  subroutine  call  to  COut  at  memory  location 
$FDED  with  a  character  in  the  accumulator.  COut  then  passes 
control  via  the  output  link  CSW  to  the  current  output  subroutine, 
normally  COutl  or  C3COutl,  which  takes  the  character  in  the 
accumulator  and  writes  it  out.  If  the  accumulator  contains  an 
uppercase  or  lowercase  letter,  a  number,  or  a  special  character, 
COutl  or  C3COutl  displays  it;  if  the  accumulator  contains  a  control 
character,  COutl  or  C3COutl  either  performs  one  of  the  special 
functions  described  below  or  ignores  the  character. 

Each  time  you  send  a  character  to  COutl  or  C3COutl,  it  displays  the 
character  at  the  current  cursor  position,  replacing  whatever  was 
there,  and  then  advances  the  cursor  position  one  space  to  the  right. 
If  the  cursor  position  is  already  at  the  right  edge  of  the  window, 
COutl  or  C3COutl  moves  it  to  the  leftmost  position  on  the  next  line 
down.  If  this  would  move  the  cursor  position  past  the  end  of  the  last 
line  in  the  window,  COutl  or  C3COutl  scrolls  the  display  up  one 
line  and  sets  the  cursor  position  at  the  left  end  of  the  new  bottom 
line. 

The  cursor  position  is  controlled  by  the  values  in  memory 
locations  $24  and  $25.  These  locations  are  named  CH,  for  cursor 
horizontal,  and  CV,  for  cursor  vertical.  COutl  and  C3COutl  do  not 
display  a  cursor,  but  the  input  routines  described  above  do,  and 
they  use  this  cursor  position.  However,  changing  CV  directly  does 
not  change  the  cursor's  vertical  position  until  the  next  carriage 
return  or  reaching  the  end  of  the  current  line  causes  a  call  to  VTab 
(for  setting  the  base  address  within  windows).  If  some  other  routine 
displays  a  cursor,  it  will  not  necessarily  put  it  in  the  cursor  position 
used  by  COutl  or  C3COutl. 

Warning     When  the  video  firmware  is  set  for  80-column  display,  the  value 
of  CH  is  kept  at  0  and  the  true  horizontal  position  is  stored 
at  $057B,  When  the  80-column  video  firmware  is  active,  use 
$057B  Instead  of  CH. 
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Escape  codes  are  described 
under  "Escape  Codes  With 
GetLn.' 


Control  characters  with  COutl 

COutl  does  not  display  control  characters.  Instead,  the  control 
characters  listed  in  Table  3-3  are  used  to  initiate  some  action  by  the 
firmware.  Other  control  characters  are  ignored.  Most  of  the 
functions  listed  here  can  also  be  invoked  from  the  keyboard,  either 
by  typing  the  control  character  listed  or  by  using  the  appropriate 
escape  code.  The  stop-list  function,  described  separately,  can  only 
be  invoked  from  the  keyboard. 


Table  3-3 

Control  characters  witti  COutl 


Control 
character 


ASCII      Apple  lie 
name      name 


Action  taken  by  COutl 


Control-G        BEL       Bell 


Control-H       BS         Backspace 


Control-J  LF  Line  feed 


Control-M        CR  Return 


Produces  a  1000-Hz  tone  for 
0.1  second 

Moves  cursor  position  one 
space  to  the  left;  from  left 
edge  of  window,  moves  to 
right  end  of  line  above 

Moves  cursor  position  down 
to  next  line  in  window; 
scrolls  if  needed 

Moves  cursor  position  to  left 
end  of  next  line  in  window; 
scrolls  if  needed 


Control  characters  with  C3COutl 

when  the  80-column  firmware  is  active,  COut  calls  C3COutl  instead 
of  COutl  for  character  output.  C3COutl  does  not  display  control 
characters,  but  you  can  use  some  control  characters  to  control 
some  of  what  the  routine  does.  All  other  control  characters  are 
ignored. 

The  control  characters  listed  in  Table  3-4  are  used  to  initiate  some 
action  by  the  firmware.  Except  for  the  stop-list  function  (Control-S) 
you  can  send  control  characters  to  C3COutl  either  from  a  program 
or  from  the  Apple  He's  keyboard.  The  stop-list  function  can  only  be 
invoked  from  the  keyboard.  Most  of  the  functions  listed  here  can 
also  be  performed  by  using  an  equivalent  escape  code. 
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Table  3-4 

Control  characters  with  C3COutl 


Control 
character 


ASCII 
narrw 


Apple  He 
name 


Action  taken  by  C3COut1 


Control-G        BEL 


Control-H        BS 


Bell  Produces  a  1000-Hz  tone 

for  0.1  second 

Backspace         Moves  cursor  position  one 
space  to  the  left;  from  left 
edge  of  window,  moves  to 
right  end  of  line  above 


Control-J 

LF 

Line  feed 

Moves  cursor  position 
down  to  next  line  in 
window;  scrolls  if  needed 

Control-K 

VT 

Clear  EOS 

Clears  from  cursor  position 
to  the  end  of  the  screen* 

Control-L 

FF 

Home  and 
clear 

Moves  cursor  position  to 
upper-left  comer  of  window 
and  clears  window* 

Control-M        CR 


Return  Moves  cursor  position  to 

left  end  of  next  line  in 
window;  scrolls  if  needed 


Control-N 

SO 

Normal 

Sets  display  format 
normal* 

Control-O 

SI 

Inverse 

Sets  display  format 
inverse* 

Control-Q 

DCl 

40-column 

Sets  display  to  40-column* 

Control-R 

DC2 

80-column 

Sets  display  to  80-column* 

Control-S 

DC3 

Stop-list 

Stops  listing  characters  on 
the  display  until  another 
key  is  pressedt 

Control-U 

NAK 

Quit 

Turns  off  enhanced  video 
firmware* 

Control-V 

SYN 

Scroll 

Scrolls  the  display  down 
one  line,  leaving  the  cursor 
in  the  current  position* 

Control-W       ETB         Scroll-up 


Scrolls  the  display  up  one 
line,  leaving  the  cursor  in 
the  current  position* 
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Table  3-4  (continued) 

Control  characters  with  CSCOutl 


Control 
character 


ASCII         Apple  lie 
name        name 


Action  taken  by  C3COut1 


Control-X        CAN        Disable 

MouseText 


Control-Y        EM 


Home 


Control-Z         SUB         Clear  line 

Control-!  ESC  Enable 

MouseText 

Control- \         FS  Fwd.  space 


Control- 


Control- 


GS 


US 


Clear  EOL 


Up 


•  Doesn't  work  from  the  keyboard, 
t  Only  works  from  the  keyboard. 


Disables  MouseText 
character  display,  uses 
inverse  uppercase 

Moves  cursor  position  to 
upper-left  comer  of  window 
(but  doesn't  clear)* 

Clears  the  line  the  cursor 
position  is  on* 

Maps  inverse  uppercase 
characters  to  MouseText 
characters 

Moves  cursor  position  one 
space  to  the  right;  from 
right  edge  of  window, 
moves  it  to  left  end  of  line 
below* 

Clears  from  the  current 
Cursor  position  to  the  end 
of  the  line  (that  is,  to  the 
right  edge  of  the  window)* 

Moves  cursor  up  a  line,  no 
scroll 


The  stop-list  feature 

You  can  stop  the  Apple  lie  from  updating  its  display  (if  it  is  using 
either  COutl  or  C3COutl)  by  pressing  Control-S.  Whenever  COutl 
or  C3COutl  gets  a  carriage  return  from  the  program,  it  checks  the 
keyboard  for  a  Control-S.  If  a  Control-S  has  been  pressed,  CCXitl  or 
C3COutl  stops  and  waits  for  another  key  to  be  pressed  before 
resuming.  The  character  code  of  the  key  that  is  pressed  is  ignored 
unless  it  is  Control-C,  which  is  passed  to  the  program.  This  feature 
lets  you  exit  BASIC  programs  from  stop-list  mode. 
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The  text  window 

The  active  portion  of  the  display  is  called  the  text  uHndow.  After 
you  start  up  the  computer  or  perform  a  reset,  the  entire  display  is 
the  text  window.  COutl  or  C3COutl  puts  characters  only  into  the 
window;  when  it  reaches  the  end  of  the  last  line  in  the  window,  it 
scrolls  only  the  contents  of  the  window. 

You  can  restrict  video  activity  to  any  rectangular  portion  of  the 
display  by  changing  the  current  text  window.  Your  programs  can 
thus  control  the  placement  of  text  in  the  display  and  protect  other 
portions  of  the  screen  from  being  written  over  by  new  text.  To  do 
this,  store  the  appropriate  values  into  four  locations  in  memory  to 
set  the  top,  bottom,  left  margin,  and  width  of  the  text  window.  The 
following  memory  locations  control  the  text  window: 

n  The  left  margin  is  stored  in  memory  location  $20.  This  number 
is  normally  0,  the  number  of  the  leftmost  column  in  the  display. 
In  a  40-column  display,  the  maximum  value  for  this  number  is  39 
Oiexadecimal  $27);  in  an  80-column  display,  the  maximum 
value  is  79  (hexadecimal  $4F). 

D  The  width  of  the  text  window  is  stored  in  memory  location  $21. 
For  a  40-column  display,  this  value  is  normally  40 
(hexadecimal  $28);  for  an  80-column  display,  it  is  normally  80 
(hexadecimal  $50). 

n  The  position  of  the  top  line  of  the  text  window  is  stored  in 
memory  location  $22.  This  is  normally  0,  the  topmost  line  in 
the  display.  Its  maximum  value  is  23  (hexadecimal  $17). 

D  The  position  of  the  bottom  line  of  the  screen  plus  1  is  stored  in 
memory  location  $23.  It  is  normally  24  (hexadecimal  $18)  for 
the  bottom  line  of  the  display.  Its  minimum  value  is  1. 

Important     Pascal  does  not  use  this  method  of  supporting  window  widths, 


Warning      Be  careful  not  to  let  the  sum  of  the  window  width  and  the 

leftmost  position  in  the  window  exceed  the  width  of  the  display 
you  are  using  (40  or  80  columns).  If  this  happens,  COutl  or 
C3COutl  may  put  characters  into  memory  locations  outside 
the  display  page,  possibly  destroying  programs  or  data. 

Table  3-5  summarizes  the  memory  locations  and  the  possible 
values  for  the  text  window  parameters. 
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Table  3-5 

Text  window  memotY  locations 


Normal  values 

Maximum  values 

LA/inrlnw 

Location 

value 

40-col. 

80-col. 

40-col. 

80-col. 

parameter 

Dec 

Hex 

Dec 

Hex 

Dec 

Hex 

Dec 

Hex 

Dec 

Hex 

Dec      Hex 

Left  edge 

32 

$20 

00 

$00 

00 

$00 

00 

$00 

39 

$27 

79        $4F 

Width 

33 

$21 

00 

$00 

40 

$28 

80 

$50 

40 

$28 

80        $50 

Top  edge 

34 

$22 

00 

$00 

00 

$00 

00 

$00 

23 

$17 

23        $17 

Bottom  edge 

35 

$23 

01 

$01 

24 

$18 

24 

$18 

24 

$18 

24        $18 

hesG  display  character  sets  are 
described  in  Cl^apter  5. 


Normal,  inverse,  and  flashing  text 

The  way  that  the  Apple  lie  displays  characters  is  affected  by  two 
things:  the  value  that  is  stored  in  the  inverse  flag  (zero  page 
location  $32),  and  whether  the  enhanced  video  firmware  is  off  or 
on.  The  inverse  flag's  influence  is  discussed  in  the  next  two 
subsections. 

If  the  enhanced  video  firmware  is  off,  the  Apple  lie  displays  what  is 
called  the  primary  character  set;  if  the  video  firmware  is  on,  the 
Apple  lie  displays  what  is  called  the  alternate  character  set. 

The  primary  character  set  includes  normal  Oight  on  dark),  inverse 
(dark  on  light),  and  flashing  (alternating  normal  and  inverse) 
characters.  Lowercase  inverse  characters  are  not  included  in  the 
primary  character  set. 

The  alternate  character  set  includes  normal  and  inverse  characters 
(including  lowercase  inverse),  and  a  set  of  graphic  characters  called 
MouseText.  Flashing  characters  are  not  included  in  the  alternate 
character  set. 

If  you  want  your  program  to  display  a  character,  it  should  first  load 
the  character  to  be  displayed  in  the  accumulator,  and  then  call  the 
character-output  subroutine  COut.  For  example,  to  display  the 
character  corresponding  to  $C8,  you  can  use  something  like  this: 

LDA   #$C8 
JSR    COut 
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For  a  brief  explanation  of  logical 
functions,  refer  to  Appendix  H. 


Primary  character  set  display 

The  primary  character  set  is  displayed  by  COutl,  which  operates 
only  when  the  enhanced  video  firmware  is  off.  The  primary 
character  set  includes  text  in  normal,  inverse,  or  flashing  format, 
but  not  inverse  or  flashing  lowercase  text. 

If  the  value  of  the  character  sent  to  COutl  is  greater  than  or  equal 
to  $A0,  that  value  is  logically  ANDed  with  the  value  of  the  inverse 
flag  (at  location  $32),  then  displayed.  (If  you're  curious  about 
which  ASCII  character  is  being  sent,  subtract  $80  from  the  value 
being  sent  to  COutl.)  You  can  use  the  following  inverse  flag  values: 

D  $FF  (decimal  255)  produces  the  normal  character  format. 

D  $3F  (decimal  63)  produces  the  inverse  character  format. 

a  $7F  (decimal  127)  produces  the  flashing  character  format. 


Important     To  avoid  unusual  character  display  results,  use  only  tine  three 
values  $3F,  $7F,  and  $FF. 

COutl  interprets  character  values  from  $80  through  $9F  as  control 
characters  and  tries  to  execute  them. 

Character  values  from  $00  through  $7F  are  all  interpreted  as 
display  characters,  not  control  characters. 


MouseText  is  described  more 
fully  In  Ctiapter  5, 


Alternate  ctiaracter  set  display 

The  alternate  character  set  includes  normal  and  inverse  format 
characters  and  the  MouseText  graphic  characters.  You  should  use 
C3COutl,  the  standard  output  link  when  the  enhanced  video 
firmware  is  active,  to  display  the  alternate  character  set  Here  are 
the  rules  for  using  the  alternate  character  set: 

n  Control  characters  are  not  displayed.  Characters  sent  to 
C3COutl  are  interpreted  as  control  characters  if  they  are  in  the 
range  $00  through  $  IF  or  $80  through  $9F. 

D  Characters  in  the  range  $20  through  $7F  and  $A0  through  $FF 
are  displayed. 

D  If  inverse  flag  (location  $32)  bit  7  is  1,  the  character  is  normal. 

D  If  inverse  flag  bit  7  is  0,  the  character  is  inverse. 

n  If  MouseText  is  off,  characters  $40  through  $5F  are  remapped  to 
the  range  $00  through  $1F  and  are  displayed  as  uppercase 
inverse  characters. 

D  If  MouseText  is  on,  character  values  $40  through  $5F  are  left 
unchanged,  and  the  characters  are  displayed  as  MouseText. 
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See  "MouseText"  In  ChopterS. 
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Port  I/O 

The  Apple  lie  is  a  member  of  the  Apple  II  family  of  computers; 
however,  unlike  the  Apple  II,  H  Plus,  and  He,  the  Apple  lie  does  not 
have  peripheral  connector  slots.  In  place  of  these,  it  has 
ports — the  equivalent  of  firmware  interface  cards  installed  in  slots. 


Standard  link  entry  points 

To  maintain  compatibility^  with  existing  software  and  its  protocols, 
each  port's  I/O  firmware  has  the  same  standard  entry 
points  (SCnOO)  as  its  equivalent  slot  in  another  Apple  II  would 
have.  Table  3-6  shows  these  equivalents,  as  well  as  listing  the 
chapter  where  each  port  is  described. 

The  section  on  the  standard  I/O  links  desaibes  how  and  when  these 
entry  addresses  are  placed  in  CSW  and  KSW.  For  example,  issuing 
PR#n  or  IN#n  changes  the  output  and  input  links,  respectively,  so 
that  subsequent  output  or  input  is  handled  by  the  firmware  starting 
at  address  $CnOO,  and  thus  goes  to  or  comes  from  the  selected 
device. 


expansion     The 

memory  expansion  version  of  the  Appie  iic  piaces  the 

mouse  at  $C700  and  the  memory  expansion  card  at  $C400, 

Table  3-6 

Port  characteristics 

Entry 

Port 

point 

Port  connector 

Use 

Chapter 

1 

$C100 

Serial  port  1 

Printers 

7 

2 

$C200 

Serial  port  2 

Communication 

8 

3 

$C300 

Video 
connectors 

Enhanced  video 
firmware 

5 

4 

$C400 

Mouse 

Mouse 

9 

5 

$C500 

Intelligent  disk 
port  devices 

6 

$C600 

Disk  drives 

Built-in  and 
external  drives 

6 

7 

$C700 

No  device 

Reserved 

6 

Important     The  addresses  shown  in  Table  3-6 

are  not  entry  points  in  the 

sense  that  you 

can  send  characters  to  be  printed  by  sending 

them  to  JSi?  SCnOO. 

Port  I/O 
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Firmware  protocol 

The  Apple  lie  supports  a  standard  firmware  protocol  that,  in 
addition  to  the  standard  link  address,  provides  a  table  of  device 
identification  and  entry  points  to  standard  and  optional  firmware 
subroutines.  The  protocol  is  equivalent  to  the  Pascal  1.1  firmware 
protocol  in  use  on  other  Apple  II's,  and  is  outlined  in  Table  3-7. 


Tablo  3-7 

Firmware  protocol  locations 


Address 

Value 

Description 

$Cn05 

$38 

Pascal  firmware  card/port  identifier. 

$Cn07 

$18 

Pascal  firmware  card/port  identifier. 

$CnOB 

$01 

Generic  signature  byte  of  a  firmware  card/port. 

$CnOC 

$ci 

Device  signature  byte:  i  is  an  identifier  (not 
necessarily  unique). 

c  =  device  class  (not  all  used  on  the  Apple  lie): 

$00 

reserved 

$01 

printer 

$02 

hand  control  or  other  X-Y  device 

$03 

serial  or  parallel  I/O  card/port 

$04 

modem 

$05 

sound  or  speech  device 

$06 

clock 

$07 

mass-storage  device 

$08 

80-column  card/port 

$09 

network  or  bus  interface 

$0A 

special  purpose  (none  of  the  above) 

$OB-OF 

reserved 

$CnOD 

ii 

$Cnii  is 

the  initialization  entry  address  (PInit). 

$CnOE 

rr 

$Cnrr  is 

the  read  routine  entry  address  (PRead) 

(returns  character  read  in  A  register). 

$CnOF 

WW 

$Cnww  is  the  write  routine  entry  address 
(PWrite)  (enters  with  character  to  write  in 
A  register). 

$CnlO 

ss 

$Cnss  is 

the  status  routine  entry  address 

$Cnll       $00 


(PStatus)  (enters  with  request  code  in  A  register: 
0  to  ask  "Are  you  ready  to  accept  output'"  or  1  to 
ask  "Do  you  have  input  ready?"). 

If  additional  address  bytes  follow;  nonzero  if  not. 
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Each  table  begins  with  identification  bytes  C$Cn05  through  $CnOC). 
Then,  starting  with  address  $CnOD,  each  byte  in  the  table 
represents  the  low-order  byte  of  the  entry-point  address  of  a 
firmware  routine.  The  high-order  byte  of  each  address  is  always 
$Cn,  where  n  is  the  port  number.  Your  program  uses  these  byte 
values  to  construct  its  own  jump  table  for  subroutine  calls  to  the 
ports. 

All  port  routines  require,  on  entry,  that  the  X  register  contain  $Cn 
and  that  the  Y  register  contain  $nO. 

All  routines,  on  exit,  return  an  error  code  in  the  X  register  (0  means 
no  error  occurred;  3  means  the  request  was  invalid).  The  carry  bit 
in  the  program  status  register  usually  contains  a  reply  to  a  request 
code  CO  means  no;  1  means  yes). 

All  the  Apple  lie  ports  except  the  disk  port  conform  to  this 
protocol.  The  disk  port  is  described  in  Chapter  6. 


For  more  information,  refer  to 
the  tiardware  page  memory 
map  in  Appendix  B. 


Table  3-8 

Port  I/O  locations 


Port 


Locations 


$C090-$C09F 

$COAO-$COAF 

$COEO-$COEF 


Port  I/O  space 

By  a  convention  used  in  other  Apple  II  series  machines,  each  port 
or  slot  has  exclusive  use  of  16  memory  locations  set  aside  for  data 
input  and  output.  The  addresses  of  these  locations  are  of  the  form 
$C080  +  #nO,  where  n  is  the  port  or  slot  number.  Table  3-8  lists  the 
port  I/O  space  used  in  the  Apple  lie. 


Port  ROM  space 

In  the  Apple  II  and  lie,  one  256-byte  page  of  memory  space  is 
allocated  to  each  slot  This  space  is  used  for  read-only  memory 
CROM  or  PROM  on  the  interface  card)  with  driver  programs  that 
control  the  operation  of  input/output  devices,  as  outlined  in 
Table  3-7.  On  the  Apple  lie,  this  space  is  dedicated  to  port 
firmware.  However,  I/O  ROM  space  in  the  Apple  lie  is  used  as 
efficiently  as  possible,  and  there  is  not  a  strict  correspondence 
between  firmware  for  port  n  and  the  $CnOO  space,  except  as  regards 
entry  points. 


Port  I/O 
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Expansion  ROM  space 

The  2K-byte  memory  space  from  $C800  to  $CFFF  in  the 
Apple  lie — called  expansion  ROM  space  on  the  Apple  II,  II  Plus, 
and  He — contains  the  enhanced  video  firmware  and  port  and 
memory  transfer  subroutines.  The  Apple  lie,  unlike  the  II,  II  Plus, 
or  lie,  always  has  this  space  switched  in. 


Port  screen  hole  RAM  space 

There  are  128  bytes  of  memory  (64  in  main  memory,  64  in  auxiliary 
memory)  allocated  to  the  ports,  eight  bytes  per  port,  as  shown  in 
Table  3-9.  These  bytes  are  reserved  for  use  by  the  system,  except  as 
described  in  Chapters  4  through  9. 


Table  3-9 

Port  screen  hole  memory  locations 

Ports 

Base 

address 

1 

2 

3 

4 

5 

6 

7 

$0478 

$0479 

$047A 

$047B 

$047C 

$047D 

$047E 

$047F 

$04F8 

$04F9 

$04FA 

$04FB 

$04FC 

$04FD 

$04FE 

$04FF 

$0578 

$0579 

$057A 

$057B 

$057C 

$057D 

$057E 

$057F 

$05F8 

$05F9 

$05FA 

$05FB 

$05FC 

$05FD 

$05FE 

$05FF 

$0678 

$0679 

$067A 

$067B 

$067C 

$067D 

$067E 

$067F 

$06F8 

$06F9 

$06FA 

$06fb 

$06FC 

$06FD 

$06fe 

$06ff 

$0778 

$0779 

$077A 

$077B 

$077C 

$077D 

$077E 

$077F 

$07F8 

$07F9 

$07FA 

$07FB 

$07FC 

$07FD 

$07FE 

$07FF 

These  addresses  are  unused  bytes  in  the  RAM  reserved  for  text  and 
low-resolution  graphics  displays,  and  hence  they  are  sometimes 
called  screen  holes.  These  particular  locations  are  not  displayed  on 
the  screen  and  their  contents  are  not  changed  by  the  built-in  output 
routines.  In  other  words,  they  are  used  by  the  output  routines  but 
they  are  not  part  of  the  video  display. 


Waming     All  thie  screen  holes  In  auxiliary  memory,  and  many  of  them  in 
main  memory,  are  reserved  for  special  use  by  Apple  lie 
firmware— for  example,  to  store  initialization  information.  Do  not 
use  any  locations  marked  reserved  in  this  manual. 

The  way  that  port  firmware  uses  these  RAM  locations  and  their 
addresses  is  covered  in  Chapters  4  through  10. 
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Interrupts 

Appendix  E  describes  Interrupt  Intermpts  are  a  way  to  more  efficiently  use  the  hardware  in  a 

handling  on  the  Apple  lie.  computer.  Internipt  support  built  into  the  Apple  He's  firmware  is 

described  briefly  below. 

When  the  IRQ  line  on  the  65C02  microprocessor  is  activated,  the 
65C02  transfers  program  control  through  the  vector  in  locations 
$FFFE  through  $FFFF  of  ROM  or  whichever  bank  of  RAM  is  switched 
in  (Chapter  2).  If  ROM  is  switched  in,  this  vector  is  the  address  of 
the  Monitor's  interrupt  handler,  which  determines  whether  the 
request  is  due  to  an  interrupt  that  should  be  handled  internally.  If 
so,  the  Monitor  handles  it  and  then  returns  control  to  the 
interrupted  program. 

If  the  interrupt  is  due  to  a  BRK  ($00)  instruction,  control  is 
transferred  through  the  BRK  vector  ($03F0-03F1).  Otherwise, 
control  is  transferred  through  the  IRQ  vector  ($03FE-$03FF). 
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This  chapter  describes  how  to  use  two  of  the  Apple  He's  built-in 
devices:  the  keyboard  and  the  speaker. 


Keyboard  input 

Table  4-1  describes  the  characteristics  of  the  keyboard  that  relate  to 
programming.  You  won't  have  to  write  routines  to  read  the 
keyboard  from  all  your  assembly-language  programs  since  the 
Apple  lie  firmware  Monitor  provides  keyboard  support  through  the 
three  standard  input  routines  described  in  Chapter  3 — RdKey, 
Keyin,  and  GetLn.  You  can  do  all  your  keyboard  handling  directly 
in  your  programs  if  you  want  to,  but  it's  nice  to  know  that  you're  not 
forced  to. 


For  a  description  of  how  the 
l<eyboard  strobe  works,  refer  to 
Appendix  E. 


Reading  the  Iceyboard 

The  keyboard  encoder  and  ROM  (see  Chapter  11)  can  generate  all 
128  ASCII  codes,  so  all  the  special  character  codes  in  the  ASCII 
character  set  are  available  from  the  keyboard.  Your  machine- 
language  programs  can  call  RdKey  to  get  characters  from  the 
keyboard.  RdKey  reads  characters  a  byte  at  a  time  from  the 
keyboard  data  location  ($COO0)  shown  in  Table  4-1. 

Here  is  how  your  programs  should  go  about  reading  the  keyboard: 

1 .  Test  bit  7  of  address  $CO(X)  to  see  if  a  key  has  been  pressed.  Bit  7 
is  the  keyboard  strobe  bit. 

2.  When  bit  7  goes  to  a  1,  you  know  that  the  low-order  seven  bits  of 
$C000  are  a  valid  character. 

3.  Clear  the  keyboard  strobe  Obit  7)  at  $C000  by  reading  or  writing 
anything  to  address  $C010. 

$C010  has  another  function  besides  clearing  the  keyboard  strobe: 
its  high  bit  is  a  1  while  a  key  is  pressed  (except  the  Apple  keys, 
Control,  Shift,  Caps  Lock,  and  Reset).  Bit  7  at  this  location  is 
therefore  called  any-key-down.  You  could  use  this  to  let  a  program 
do  something  useful  other  than  just  waiting  for  the  next  key  to  be 
pressed.  (People  are  generally  a  lot  slower  than  the  Apple  lie.) 
Check  $C010  occasionally  to  see  if  something  should  be  done. 


Important 


If  your  program  needs  to  read  both  ttie  l<eyboard  flag  and  the 
strobe,  it  must  read  the  strobe  bit  first.  Any  time  you  read  the 
any-key-down  bit  at  $0010,  you  aiso  ciear  the  keyboard  strobe 
bit  at  $0000, 
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Table  4-1 

Keyboard  Input  characteristics 


Dn  gam©  Input  switches,  see 
Chapter  9, 


On  GetLn.  GetLn  1.  and  RdKey. 
see  Chapter  3. 


Port  numbor  None 

Commands  Keyboard  is  always  on,  in  the  sense  that  any 

keypress  generates  a  KSTRB. 

Initial  Reset  routine  clears  the  keyboard  strobe  and  sets 

characteristics       the  keyboard  as  the  standard  input  device  (that  is, 
sets  KSW  to  point  to  RdKey). 


Hardware  locations 

$C000  Keyboard  data  and  strobe 

$C010  Any-key-down  flag  and  clear-strobe  switch 

$C060  40-column  switch  status  on  bit  7;  1  =  40-column 

display  =  switch  down 

$C06l  Open  Apple  status  on  bit  7;  1  =  pressed  (also 

game  input  switch  0) 

$C062  Solid  Apple  status  on  bit  7;  1  =  pressed 


Monitor  firmware 
routines 

Location 

$FD6A 

Name 

GetLn 

$FD67 

GetLnZ 

$fd6f 

GetLnl 

$FD1B 

Keyin 

$FD35 

RdChar 

$FDOC 

RdKey 

Description 

Gets  an  input  line  with  prompt 

Gets  an  input  line  with  preceding  carriage 
return 

Gets  an  input  line,  but  with  no  preceding 
prompt 

The  keyboard  input  subroutine 

Gets  an  input  character  or  escape  code 

The  standard  character  input  subroutine 

Use  of  ottier  pages 

Page  2  The  standard  character  string  input  buffer  (see  GetLn 

description) 

After  your  program  has  cleared  the  keyboard  strobe,  the  strobe 
remains  low  until  another  key  is  pressed. 

Table  4-2  shows  the  ASCII  codes  generated  by  all  the  keys  on  the 
Apple  lie  keyboard.  Remember,  if  the  strobe  bit  is  set,  the 
character  values  that  your  program  sees  will  be  equal  to  the  values 
given  in  Table  4-2  plus  $80. 


Keyboard  input 
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Tablo  4-2 

Keys  and  ASCII  codes 


Key  alone 


■I-  Control 


+  Shift 


+  Both 


Key 

Code 

1  Char 

Code 

»  Char 

Code 

»  Char 

Code 

»  Char 

Delete 

7F 

DEL 

7F 

DEL 

7F 

DEL 

7F 

DEL 

Left  Arrow 

08 

BS 

08 

BS 

08 

BS 

08 

BS 

Tab 

09 

HT 

09 

HT 

09 

HT 

09 

HT 

Down  Arrow 

OA 

LF 

OA 

LF 

OA 

LF 

OA 

LF 

Up  Arrow 

OB 

VT 

OB 

VT 

OB 

VT 

OB 

VT 

Return 

OD 

CR 

OD 

CR 

OD 

CR 

OD 

CR 

Right  Arrow 

15 

NAK 

15 

NAK 

15 

NAK 

15 

NAK 

Escape 

IB 

ESC 

IB 

ESC 

IB 

ESC 

IB 

ESC 

Space 

20 

SP 

20 

SP 

20 

SP 

20 

SP 

1  It 

27 

1 

27 

f 

22 

H 

22 

M 

,  < 

2C 

» 

2C 

1 

3C 

< 

3C 

< 

-  _ 

2D 

- 

IF 

US 

5F 

IF 

US 

.  > 

2E 

2E 

, 

3E 

> 

3E 

> 

/? 

2F 

/ 

2F 

/ 

3F 

? 

3F 

7 

0) 

30 

0 

30 

0 

29 

) 

29 

) 

1  ! 

31 

1 

31 

1 

21 

I 

21 

I 

2@ 

32 

2 

00 

NUL 

40 

@ 

00 

NUL 

3# 

33 

3 

33 

3 

23 

# 

23 

# 

4$ 

34 

4 

34 

4 

24 

$ 

24 

$ 

5% 

35 

5 

35 

5 

25 

% 

25 

% 

6a 

36 

6 

IE 

RS 

5E 

A 

IE 

RS 

7& 

37 

7 

37 

7 

26 

& 

26 

& 

8  ♦ 

38 

8 

38 

8 

2A 

* 

2A 

* 

9( 

39 
3B 

9 

» 

39 
3B 

9 

f 

28 
3A 

( 

28 
3A 

( 

=  + 

3D 

ss 

3D 

= 

2B 

+ 

2B 

+ 

[{ 

5B 

[ 

IB 

ESC 

7B 

{ 

IB 

ESC 

\  1 

5C 

\ 

IC 

FS 

7C 

1 

IC 

FS 

]} 

5D 

] 

ID 

GS 

7D 

} 

ID 

GS 

!  ~ 

60 

! 

60 

! 

7E 

~ 

7E 

~ 

A 

61 

a 

01 

SOH 

41 

A 

01 

SOH 

B 

62 

b 

02 

STX 

42 

B 

02 

STX 

C 

63 

c 

03 

ETX 

43 

C 

03 

ETX 

D 

64 

d 

04 

EOT 

4A 

D 

04 

EOT 

E 

65 

e 

05 

ENQ 

45 

E 

05 

ENQ 

F 

66 

f 

06 

ACK 

A6 

F 

06 

ACK 

G 

61 

g 

07 

BEL 

47 

G 

07 

BEL 

H 

68 

h 

08 

BS 

48 

H 

08 

BS 

I 

69 

i 

09 

HT 

49 

I 

09 

HT 

80 
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Table  4-2  (continued) 
Keys  and  ASCII  codes 

Key  alone 
Code  Char 

+  Control 

+  Shift 

+  Both 

Key 

Code 

1  Char 

Code 

1  Char 

Code 

>  Char 

J 

6A 

J 

OA 

LF 

4A 

J 

OA 

LF 

K 

6B 

k 

OB 

VT 

4B 

K 

OB 

VT 

L 

6C 

1 

OC 

FF 

4C 

L 

OC 

FF 

M 

6D 

m 

OD 

CR 

4D 

M 

OD 

CR 

N 

6e 

n 

OE 

SO 

4E 

N 

OE 

SO 

O 

6f 

o 

OF 

SI 

4F 

O 

OF 

SI 

P 

70 

P 

10 

DLE 

50 

P 

10 

DLE 

Q 

71 

q 

11 

DCl 

51 

Q 

11 

DCl 

R 

72 

r 

12 

DC2 

52 

R 

12 

DC2 

S 

73 

s 

13 

DC3 

53 

S 

13 

DC3 

T 

74 

t 

14 

DC4 

54 

T 

14 

DC4 

U 

75 

u 

15 

NAK 

55 

U 

15 

NAK 

V 

76 

V 

16 

SYN 

56 

V 

16 

SYN 

w 

77 

w 

17 

ETB 

57 

W 

17 

ETB 

X 

78 

X 

18 

CAN 

58 

X 

18 

CAN 

Y 

79 

y 

19 

EM 

59 

Y 

19 

EM 

Z 

7A 

z 

lA 

SUB 

5A 

Z 

lA 

SUB 

Note:  Codes  are  in  hexadecimal  here;  refer  to  Table  G-8  for  decimal 
equivalents. 


Keystrol<©s  con  also  generate 
interrupts.  See  Appendix  E. 


The  reset  routine  Is  described  In 
Cl-iapter  2. 


For  information  on  how  to  have 
programs  interpret  l<eystroi<es  In 
□  standard  way,  refer  to  the 
Apple  II  Design  Guidelines  listed 
n  the  Bibliography. 


There  are  several  keys  that  do  not  generate  ASCII  codes  themselves, 
but  alter  the  characters  produced  by  other  keys.  These  modifier  keys 
are  Control,  Shift,  and  Caps  Lock. 

Your  programs  can  also  use  the  Open  Apple  and  Solid  Apple  as 
character  modifier  keys  while  handling  keyboard  input,  and,  if  one 
or  both  of  them  are  pressed,  branch  to  a  special  routine,  such  as  a 
help  program.  Your  program  can  read  Open  Apple  at  $C06l  and 
Solid  Apple  at  $C062. 

Another  key  that  doesn't  generate  a  code  is  Reset,  located  at  the 
upper-left  corner  of  the  keyboard;  it  is  connected  directly  to  the 
Apple  He's  processor.  Pressing  Reset  with  Control  depressed 
normally  causes  the  system  to  stop  whatever  program  it's  running 
and  restart  itself.  If  you  hold  Open  Apple  while  pressing  Control- 
Reset,  the  Apple  lie  performs  a  forced  cold  start.  The  restart 
sequence  is  described  in  Chapter  2. 


Keyboard  input 
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Monitor  firmware  support  for  keyboard  input 

Chapter  3  describes  the  three  standard  Monitor  input  routines 
serving  the  keyboard:  GetLn,  RdKey,  and  Keyln.  This  section 
discusses  the  three  other  available  Monitor  routines. 


GetLnZ 

GetLnZ  (at  address  $FD67)  is  an  alternate  entry  point  for  GetLn  that 
first  sends  a  carriage  return  to  the  standard  output,  then  continues 
into  GetLn. 

GetLn  1 

GetLn  1  (at  address  $FD6F)  is  an  alternate  entry  point  for  GetLn  that 
does  not  issue  a  prompt  before  it  accepts  the  input  line.  However,  if 
the  user  cancels  the  input  line  with  too  many  backspaces  or  with 
Control-X,  then  GetLnl  issues  the  prompt  stored  at  location  $33 
when  it  gets  another  line. 

RdChar 

RdChar  (at  address  $FD35)  is  a  subroutine  that  gets  characters  from 
the  standard  input  subroutine,  and  also  interprets  the  escape  codes 
listed  in  Chapter  3. 

If  the  enhanced  video  firmware  is  active.  Right  Arrow  (Control-U) 
reads  a  character  from  the  screen  as  if  it  were  typed  from  the 
keyboard.  This  is  a  function  of  the  Monitor's  built-in  editing 
capability  described  in  Chapter  3. 


Electrical  specifications  of  the 
speaker  circuit  appear  In 
Chapter  1 1 . 


Speaker  output 

The  Apple  lie  has  a  small  speaker  mounted  near  the  front  of  the 
bottom  plate  of  its  case.  The  speaker  is  connected  to  a  soft  switch 
that  toggles;  that  is,  the  switch  has  two  states,  off  and  on,  and  it 
changes  from  one  to  the  other  each  time  it  is  accessed.  Table  4-3 
describes  the  speaker  output  characteristics. 
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Table  4-3 

Speaker  output  characteristics 


Port  number  None. 

Commands  Some  programs  sound  the  speaker  in  response  to 

Control-G. 

Initial  Reset  routine  sounds  the  speaker, 

characteristics 

Hardware  iocation 

$C030  Toggle  speaker  (read  only). 

Monitor  firmware 
routines 

Location         Name        Description 

$FBDD        Belli        Sends  a  beep  to  the  speaker. 

$FF3A  Bell 


Sends  Control-G  to  the  current  output. 


Using  the  speaker 

If  you  switch  the  speaker  once,  by  reading  or  writing  to  $C030,  it 
emits  a  click;  to  make  longer  sounds,  access  the  speaker  repeatedly. 
The  switch  for  the  speaker  uses  memory  location  $C030.  You  can 
make  various  tones  and  buzzes  with  the  speaker  by  using 
combinations  of  timing  loops  in  your  program. 


Important     You  shouid  always  use  a  read  operation  to  toggle  the  speaker. 
If  you  write  to  this  soft  switch,  it  switches  twice  In  rapid 
succession.  The  resulting  pulse  is  so  short  that  the  speaker 
doesn't  have  time  to  respond;  It  doesn't  make  a  sound. 


Speaker  output 
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Monitor  firmware  support  for  spealcer  output 

See  Chapter  3.  The  Monitor  supports  the  speaker  with  one  simple  routine,  Belli.  A 

related  routine,  Bell,  supports  the  current  output  device — the  one 
that  CSW  points  to. 

BeUl 

Belli  (at  address  $FDBB)  makes  a  beep  through  the  speaker  by 
generating  a  l-kHz  tone  in  the  Apple  He's  speaker  for  0.1  second. 
This  routine  scrambles  the  A  and  X  registers. 

Bell 

The  Monitor  routine  Bell  (at  location  $FF3A)  writes  a  bell  control 
character  (ASCII  Control-G)  to  the  current  output  device.  This 
routine  leaves  the  accumulator  holding  $87. 
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NTSC  stands  for  National 
Television  Standards 
Committee,  a  group  that 
formulates  broadcast  and 
reception  guidelines  used  by  ttie 
USA  and  several  other  countries. 


The  Apple  He's  primary  output  device  is  its  video  display.  You  can 
use  any  ordinary  color  or  monochrome  video  monitor  with  the 
Apple  lie.  An  ordinary  monitor  is  one  that  accepts  NTSC- 
compatible  composite  video.  If  you  use  Apple  lie  color  graphics 
with  a  black-and-white  monitor,  the  display  vwU  appear  as  black, 
white,  and  two  shades  of  gray. 

If  you  are  only  using  graphics  modes  and  40-cblumn  text,  you  can 
use  a  television  set  for  your  video  display.  If  the  TV  set  has  an  input 
connector  for  composite  video,  you  can  connect  it  directly  to  your 
Apple  IIc;  otherwise,  you  must  attach  an  RF  video  modulator 
between  the  Apple  IIc  and  the  television  set 


Important     The  Apple  IIc  can  produce  an  80-column  text  display.  However, 
if  you  use  an  ordinary  color  or  black-and-white  television  set, 
80-column  text  will  be  too  blurry  to  read.  For  a  clear  80-coiumn 
display,  you  must  use  a  high-resolution  video  monitor  with  a 
bandwidth  of  14  MHz  or  greater. 

Table  5-1  summarizes  the  video  output  port's  characteristics  and 
points  to  other  information  in  this  chapter. 


Table  5-1 

Video  output  port  characteristics 


Port  number 

Commands 

Initial 
characteristics 


Hardware 
locations 

Monitor  firmware 
routines 

I/O  firmware 
entry  points 


Output  port  3. 

See  Figure  5-3. 

See  Figure  5-3. 

Note:  If  a  program  is  to  use  the  enhanced  video 
firmware,  it  should  turn  it  on  and  then 
immediately  check  the  80/40  switch.  If  the 
switch  is  in  the  40  position,  the  program 
should  issue  a  Control-Q. 

See  Table  5-7. 
See  Table  5-11. 
See  Table  5-12. 
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Video  display  specifications 

Table  5-2  summarizes  the  video  display's  specifications,  and 
provides  a  further  guide  to  other  information  in  this  chapter. 

Table  5-2 

Video  display  specifications 


Display  modes 


Text  capacity 

Ctioracter  set 

Display  formats 

Low-resolution 
graphics 

High-resolution 
graphics 


Double  high-resolution 
graphics 


40-column  text;  map:  Figure  5-5 
80-column  text;  map:  Figure  5-6 

Low-resolution  color  graphics; 
map:  Figure  5-7 

High-resolution  color  graphics; 
map:  Figure  5-8 

Double  high-resolution  color 
graphics;  map:  Figure  5-9 

24  lines  by  80  columns  (character 
positions) 

96  ASCII  characters  (uppercase  and 
lowercase) 

Normal,  inverse,  flashing, 
MouseText  CTable  5-3) 

16  colors  (Table  5-4):  40  horizontal 
by  48  vertical;  map:  Figure  5-7 

6  colors  (Table  5-5):  140  horizontal 
by  192  vertical  (restricted) 

Black  and  white:  280  horizontal 
by  192  vertical;  map:  Figure  5-8 

16  colors  (Table  5-6):  140  horizontal 
by  192  vertical  (no  restrictions) 

Black  and  white:  560  horizontal 
by  192  vertical;  map:  Figure  5-9 


See  "Video  Output  Signals"  In 
Chapter  1 1  for  more  on  video 
expansion  hardware. 


The  video  signal  produced  by  the  Apple  He  is  NTSC-compatible 
composite  color  video  available  at  two  places  on  the  back  panel  of 
the  Apple  IIc:  the  RCA-type  phono  jack  and  the  15-pin  D-type 
connector.  Use  the  RCA-type  phono  jack  to  connect  a  video 
monitor,  and  the  DB-15  connector  for  an  external  video  modulator 
or  other  video  expansion  hardware. 


Video  display  specifications 
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Text  modes 

Either  of  the  Apple  He's  two  text  modes  can  display  all  96  ASCII 
characters:  uppercase  and  lowercase  letters,  the  ten  digits, 
punctuation  marks,  and  special  characters.  Each  character  is 
displayed  in  an  area  of  the  screen  that  is  seven  dots  wide  by  eight 
dots  high.  The  characters  are  formed  by  a  dot  matrix  five  dots  wide 
(with  a  few  exceptions,  such  as  underscore),  leaving  two  blank 
columns  of  dots  between  characters  in  a  row.  Except  for  lowercase 
letters  with  descenders,  the  characters  are  only  seven  dots  high, 
leaving  one  blank  line  of  dots  between  rows  of  characters. 

The  normal  display  has  white  (or  other  monochrome  color  used  by 
your  monitor)  dots  on  a  dark  background.  Characters  can  also  be 
displayed  as  black  dots  on  a  white  background;  this  is  called 
inverse  video. 


Text  Character  sets 

The  Apple  lie  can  display  either  of  two  text  character  sets:  the 
primary  set  and  an  alternate  set  (Table  5-3).  The  forms  of  the 
characters  in  the  two  sets  are  actually  the  same,  but  the  available 
display  formats  are  different.  The  display  formats  are 

'  n  normal,  with  white  dots  on  a  black  screen 

D  inverse,  with  black  dots  on  a  white  screen 

n  flashing,  alternating  between  normal  and  inverse 

The  Apple  He  can  display  uppercase  characters  in  all  three 
formats — normal,  inverse,  and  flashing — ^with  the  primary 
character  set.  Lowercase  letters  can  only  be  displayed  in  normal 
format.  This  makes  the  primary  character  set  compatible  with  most 
software  written  for  the  Apple  II  and  II  Plus,  which  can  display  text 
in  flashing  format  but  don't  have  lowercase  characters. 

The  alternate  character  set  trades  the  flashing  format  for  a  complete 
set  of  inverse  characters.  With  the  alternate  character  set,  the 
See  "MouseText."  Apple  lie  can  display  uppercase  letters,  lowercase  letters,  numbers, 

and  special  characters  in  either  normal  format  or  inverse  format  It 
can  also  display  MouseText. 
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To  identify  particular  characters 
and  vaiues,  refer  to  Table  4-2. 


You  can  select  between  character  sets  with  the  alternate-text  soft 
switch,  described  later  in  this  chapter.  Table  5-3  shows  the 
character  codes  in  decimal  and  hexadecimal  for  the  Apple  lie 
primary  and  alternate  character  sets  in  normal,  inverse,  and 
flashing  formats. 


Table  5-3 

Display  character  sets 

Hex 

Primary  character  set 
Character  type       Format 

Alternate  character  set 

values 

Character  type 

Format 

$00-$ IF 

Uppercase 
letters 

Inverse 

Uppercase 
letters 

Inverse 

$20-$3F 

Special 
characters 

Inverse 

Special 
characters 

Inverse 

$40-$ 5F 

Uppercase 
letters 

Flashing 

MouseText 

$60-$7F 

Special 
characters 

Flashing 

Lowercase 
letters 

Inverse 

$80-$9F 

Uppercase 
letters 

Normal 

Uppercase 
letters 

Normal 

$AO-$BF 

Special 
characters 

Normal 

Special 
character 

Normal 

$CO-$DF 

Uppercase 
letters 

Normal 

Uppercase 
letters 

Normal 

$EO-$FF 

Lowercase 
letters 

Normal 

Lowercase 
letters 

Normal 

Each  character  on  the  screen  is  stored  as  one  byte  of  display  data. 
The  low-order  six  bits  make  up  the  ASCII  code  of  the  character 
being  displayed.  The  remaining  two  (high-order)  bits  select  format 
and  the  group  within  ASCII. 


Text  modes 


89 


MouseText 

The  alternate  character  set  contains  32  graphics  characters  called 
MouseText  in  place  of  the  primary  set's  inverse  uppercase 
characters  from  $40  through  $5F.  These  graphics  are  especially 
convenient  to  use  with  a  mouse  because  they  can  be  generated  by 
character  codes  instead  of  groups  of  high-resolution  byte  values, 
and  they  can  be  moved  around  quickly.  To  use  MouseText 
characters,  do  the  following: 

1.  Turn  on  the  enhanced  video  firmware  with  PR#3  or  6  Control-P. 

2.  Set  inverse  mode:  use  the  INVERSE  command  or  put  $3F  in 
location  $32,  or  print  Control-O. 

3.  Turn  on  MouseText  with  PRINT  CHR$(27);  or  pass  $1B  to  COut 
in  the  accumulator. 

4.  Print  the  uppercase  letter  (or  other  ASCII  character  in  the  range 
$40  throu^  $5F:@[  \]  A  or  _  )  that  corresponds  to  the 
MouseText  character  you  want. 

5.  Turn  off  MouseText  with  PRINT  CHR$(24);  or  pass  $18  to  COutl 
in  the  accumulator. 

6.  Set  normal  mode:  use  the  NORMAL  command  or  put  $FF  in 
location  $32,  or  print  a  Control-N. 

Here  is  a  sample  Applesoft  program  that  prints  all  the  MouseText 
characters: 

10  D$=CHR$(4) 

20  PRINT  PRINT  D$;"PR#3" 

30  INVERSE 

40  PRINT  CHR$  (27)  ;"ABCDEFGHIJKLMNOPQRSTUVWXYZ  []'■_", • 

50  PRINT  CHR$(24) ; 

60  NORMAL 

MouseText  characters  and  their  corresponding  ASCII  characters  are 
shown  in  Figure  5-1. 
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Ik  6  K  Z  ^  B  HI 

@  A  B  C  D  E  F 

<-  ...  >|.  t  ~  4J     ■ 

H  I  J  K  L  M 

ilL  ^  ^  -  L  ^ 


M  N 


P  Q 


I  ♦  z 


U 


Jl- 


-.r     3 

[  \  ]  ■ 


Figure  5-1 

MouseText  characters 


w 


40-column  versus  80-column  text 

The  Apple  lie  has  two  text  display  modes:  40-column  and  80- 
column.  The  number  of  dots  in  each  character  does  not  change, 
but  the  characters  in  80-column  mode  are  only  half  as  wide  as  the 
characters  in  40-column  mode.  Compare  the  two  displays  in 
Figure  5-2.  On  an  ordinary  color  or  black-and-white  television  set, 
the  narrow  characters  in  the  80-column  display  blur  together;  you 
must  use  the  40-column  mode  to  display  text  on  a  television  set. 


Text  modes 
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]LIST  0,100 

10   REM  APPLESOFT  CHARACTER  DEMO 

20   TEXT  :  HOME 

30  PRINT  :  PRINT  "Applesoft  Char 

acter  Demo" 
40  PRINT  :  PRINT  "Which  characte 

r  set  — " 
50  PRINT  :  INPUT  "Primary  (P)  or 

Alternate  (A)  ?";A$ 
60   IF   LEN  (A$)  <  1  THEN  50 
65   LET  A$  =   LEFT$  (A$,l) 
70   IF  A$  =  "P"  THEN   POKE  4  9166, 

0 
80   IF  A$  =  "A"  THEN   POKE  4  9167, 

0 
90   PRINT  :  PRINT  "...printing  th 

e  same  line,  first" 
100   PRINT  "  in  NORMAL,  then  INVE 
RSE  ,then  FLASH:":  PRINT 


]LIST 

10  REM  APPLESOFT  CHARACTER  DEMO 

20  TEXT  :  HOME 

30  PRINT  :  PRINT  "Applesoft  Character  Demo" 

40  PRINT  :  PRINT  "Which  character  set — " 

50  PRINT  :  INPUT  "Primary  (P)  or  Alternate  (A)  ?";A$ 

60  IF   LEN  (A$)  <  1  THEN  50 

70  LET  A$  =  LEFT$  (A$, 1) 

80  IF  A$  =  "P"  THEN  POKE  4  9166,0 

90  IF  A$  =  "A"  THEN  POKE  4  9167,0 

100  PRINT  :  PRINT  "...printing  the  same  line,  first" 

150  PRINT  "  in  NORMAL,  then  INVERSE  ,then  FLASH:":  PRINT 

160  NORMAL  :  GOSUB  1000 

17  0  INVERSE  :  GOSUB  1000 

180  FLASH  :  GOSUB  1000 

190  NORMAL  :  PRINT  :  PRINT  :  PRINT  "Press  any  key  to  repeat."  GET  A$ 

200  GOTO  10 

1000  PRINT  :  PRINT  "SAMPLE  TEXT:  Now  is  the  time — 12:00" 

1100  RETURN 

]■ 

Figure  5-2 

40-column  and  80-column  text  with  alternate  character  set 
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Figure  5-3  shows  the  characteristics  of  the  text  display  modes  and 
how  to  switch  between  them. 


Power  On 


(ESC)(C0NTR0r)-rQl 
Resets  full 
40-column  window 


Cursor:  square  box 
Input  hook:  C3Keyln 
Output  hook:  C3C0ut1 
Window:  40  columns, 

24  lines 
Character  Set:  alternate 

Figure  5-3 

Text  mode  characteristics  and  switclning 


Cursor:  narrow  box 
Input  hook:  C3Keyln 
Output  hook:  CSCOutI 
Window:  80  columns, 

24  lines 
Character  Set:  alternate 


Text  modes 
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Graphics  modes 


Table  5-4 

Low-resolution 

graphics 

colors 

Nibble  value 

Dec 

Hex 

Color 

0 

$00 

Black 

1 

$01 

Magenta 

2 

$02 

Dark  blue 

3 

$03 

Purple 

4 

$04 

Dark  green 

5 

$05 

Gray  1 

6 

$06 

Medium  blue 

7 

$07 

Light  blue 

8 

$08 

Brown 

9 

$09 

Orange 

10 

$0A 

Gray  2 

11 

$0B 

Pink 

12 

$0C 

Light  green 

13 

$0D 

Yellow 

14 

$0E 

Aquamarine 

15 

$0F 

White 

The  Apple  lie  can  produce  color  video  graphics  in  any  of  three 
different  modes: 

D  low-resolution  graphics,  48  rows  by  40  columns 

n  high-resolution  graphics,  192  rows  by  280  columns 

n  double  high-resolution  graphics,  192  rows  by  560  columns 

Each  graphics  mode  treats  the  screen  as  a  rectangular  array  of 
spots.  Normally,  your  programs  will  use  the  features  of  some  high- 
level  language  to  draw  graphics  dots,  lines,  and  shapes  on  the 
screen;  this  section  describes  the  way  the  resulting  graphics  data  are 
stored  in  the  Apple  He's  memory. 


Low-resolution  graphics 

The  Apple  lie  displays  an  array  of  48  rows  by  40  columns  of  colored 
blocks  in  the  low-resolution  graphics  mode.  Each  block  can  be  any 
one  of  sixteen  colors,  including  black  and  white.  On  a  black-and- 
white  monitor  or  television  set,  these  colors  appear  as  black,  white, 
and  two  shades  of  gray.  There  are  no  blank  dots  between  blocks; 
adjacent  blocks  of  the  same  color  merge  to  make  a  larger  shape. 

The  low-resolution  graphics  display  data  are  stored  in  the  same  part 
of  memory  as  the  data  for  the  40-column  text  display.  Each  byte 
contains  data  for  two  low-resolution  graphics  blocks.  The  two  blocks 
are  displayed  one  atop  the  other  in  a  display  space  the  same  size  as 
a  40-column  text  character,  seven  dots  wide  by  eight  dots  high. 

Half  a  byte — four  bits,  or  one  nibble — is  assigned  to  each  graphics 
block.  Each  nibble  can  have  a  value  from  0  to  15,  and  this  value 
determines  which  one  of  sixteen  colors  appears  on  the  screen.  The 
colors  and  their  corresponding  nibble  values  are  shown  in 
Table  5-4.  In  each  byte,  the  low-order  nibble  sets  the  color  for  the 
top  block  of  the  pair,  and  the  high-order  nibble  sets  the  color  for 
the  bottom  block.  Thus,  a  byte  containing  the  hexadecimal 
value  $D8  produces  a  brown  block  atop  a  yellow  block  on  the 
screen. 


Note:  colors  may  vary,  depending 
on  adjustment  of  monitor  or 
television  set. 
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As  explained  earlier  in  this  chapter,  the  text  display  and  the  low- 
resolution  graphics  display  use  the  same  area  in  memory.  Your 
programs  should  usually  dear  this  part  of  memory  when  they 
change  display  modes,  but  you  can  store  data  as  text  and  display 
them  as  graphics,  or  vice  versa.  All  you  have  to  do  is  change  the 
mode  switch,  described  later  in  this  chapter,  without  changing  the 
display  data.  This  usually  produces  meaningless  jumbles  on  the 
display,  but  some  programs  have  used  this  technique  to  good 
advantage  for  producing  complex  low-resolution  graphics  displays 
quickly. 


High-resolution  graphics 

In  the  high-resolution  graphics  mode,  the  Apple  lie  displays  an 
array  of  colored  dots  in  192  rows  and  280  columns.  The  colors 
available  are  black,  white,  purple,  green,  orange,  and  blue, 
although  the  colors  of  the  individual  dots  are  limited,  as  described 
below,  by  the  color  of  adjacent  dots.  Adjacent  dots  of  the  same 
color  merge  to  form  a  continuous  colored  area. 

High-resolution  graphics  display  data  are  stored  in  either  of  two 
8192-byte  areas  in  memory.  These  areas  are  called  high-resolution 
Page  1  and  Page  2;  think  of  them  as  display  data  buffers.  Normally, 
your  programs  will  use  the  features  of  some  high-level  language  to 
draw  graphics  dots,  lines,  and  shapes  to  display,  this  section 
describes  the  way  the  resulting  graphics  data  are  stored  in  the 
Apple  He's  memory. 

The  Apple  lie  high-resolution  graphics  display  is  bit-mapped:  each 
dot  on  the  screen  corresponds  to  a  bit  in  the  Apple  He's  memory. 
The  seven  low-order  bits  of  each  display  byte  control  a  row  of  seven 
adjacent  dots  on  the  screen,  and  40  adjacent  bytes  in  memory 
control  a  row  of  280  (7  times  40)  dots.  The  eighth  bit  (the  most 
significant)  of  each  byte  is  not  displayed;  it  selects  one  of  two  color 
sets,  as  described  below.  The  least  significant  bit  of  each  byte  is 
displayed  as  the  leftmost  dot  in  a  row  of  seven,  followed  by  the  next- 
least  significant  bit,  and  so  on,  as  shown  in  Figure  5-4. 
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Dots  on  Graphics  Screen 

Figure  5-4 

High-resolution  display  bits 

There  is  a  simple  correspondence  between  bits  in  memory  and  dots 
on  the  screen  on  a  black-and-white  monitor.  A  dot  is  white  if  the  bit 
controlling  it  is  on  (1),  and  the  dot  is  black  if  the  bit  is  off  (0).  On  a 
black-and-white  television  set,  pairs  of  dots  merge  together; 
alternating  black  and  white  dots  merge  to  a  continuous  gray. 

A  dot  whose  controlling  bit  is  off  (0)  is  black  on  an  NTSC  color 
monitor  or  a  color  television  set.  If  the  bit  is  on,  the  dot  is  white  or  a 
color,  depending  on  its  position,  the  dots  on  either  side,  and  the 
setting  of  the  high-order  bit  of  the  byte.  Call  the  leftmost  column  of 
dots  column  0,  and  assume  (for  the  moment)  that  the  high-order 
bits  of  all  the  data  bytes  are  off  (0).  If  the  bits  that  control  them  are 
on,  dots  in  even-numbered  columns,  0,  2,  4,  and  so  forth,  are 
purple,  and  dots  in  odd-numbered  columns  are  green — ^but  only  if 
the  dots  on  either  sidfe  are  black.  If  two  adjacent  dots  are  both  on, 
they  are  both  white. 

You  select  the  other  two  colors,  blue  and  orange,  by  turning  the 
high-order  bit  0>it  7)  of  a  data  byte  on  (1).  The  colored  dots 
controlled  by  a  byte  with  the  high-order  bit  on  are  either  blue  or 
orange:  the  dots  in  even-numbered  columns  are  blue,  and  the  dots 
in  odd-numbered  columns  are  orange  (again,  only  if  the  dots  on 
either  side  are  black).  Within  each  horizontal  line  of  seven  dots 
controlled  by  a  single  byte,  you  can  have  black,  white,  and  one  pair 
of  colors.  To  change  the  color  of  any  dot  to  one  of  the  other  pair  of 
colors,  you  must  change  the  high-order  bit  of  its  byte,  which  affects 
the  colors  of  all  seven  dots  controlled  by  the  byte. 
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In  brief,  high-resolution  graphics  displayed  on  a  color  monitor  or 
television  set  are  made  up  of  colored  dots,  according  to  the 
following  rules: 

n  Dots  in  even-numbered  columns  can  be  black,  purple,  or  blue. 

n  Dots  in  odd-numbered  columns  can  be  black,  green,  or  orange. 

n  If  adjacent  dots  in  a  row  are  both  on,  they  are  both  white. 

n  The  colors  in  each  row  of  seven  dots  controlled  by  a  single  byte 
are  either  purple  and  green,  or  blue  and  orange,  depending  on 
whether  the  high-order  bit  is  off  (0)  or  on  (1). 

These  rules  are  summarized  in  Table  5-5.  The  blacks  and  whites  are 
numbered  to  remind  you  that  the  high-order  bit  is  different. 

Table  5-5 

High-resolution  graphics  colors 


Bits  0-6 


Bit  7  off       Bit  7  on 


Adjacent  columns  off 
Even  columns  on 
Odd  columns  on 
Adjacent  columns  on 


Black  1  Black  2 

Purple  Blue 

Green  Orange 

White  1  White  2 


Note:  Colors  may  vary,  depending  on  adjustment 
of  monitor  or  television  set. 


For  more  details  about  the  way 
the  Apple  lie  produces  color  on  a 
TV  set,  see  Chapter  11.  For  a 
table  of  reversed  bit  patterns, 
refer  to  Appendix  H. 


The  peculiar  behavior  of  the  high-resolution  colors  reflects  in  part 
the  way  NTSC  color  television  works.  The  dots  that  make  up  the 
Apple  lie  video  signal  are  spaced  to  coincide  with  the  frequency  of 
the  color  subcarrier  used  in  the  NTSC  system.  Alternating  on  and 
off  dots  at  this  spacing  cause  a  color  monitor  or  TV  set  to  produce 
color,  but  two  or  more  on  dots  together  do  not. 


Double  high -resolution  graphics 

The  horizontal  resolution  of  double  high-resolution  graphics  is 
560  dots  per  line,  with  192  lines.  Double  high-resolution  graphics 
maps  the  low-order  seven  bits  of  the  bytes  in  the  two  double  high- 
resolution  graphics  pages.  A  double  high-resolution  page  is  made 
up  of  a  8192-byte  page  in  main  memory  and  an  equivalent  page 
having  the  same  address  in  auxiliary  memory.  In  most  cases,  only 
the  first  double  high-resolution  graphics  page  is  used. 
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The  bytes  in  the  main-memory  and  auxiliary-memory  pages  are 
displayed  in  exactly  the  same  manner  as  the  charaaers  in  80- 
column  text:  of  each  pair  of  identical  addresses,  the  auxiliary- 
memory  byte  is  displayed  first,  and  the  main-memory  byte  is 
displayed  second.  A  dot  whose  controlling  bit  is  off  (0)  is  black 
when  displayed. 

Unlike  high-resolution  color,  double  high-resolution  color  has  no 
restrictions  on  which  colors  can  be  adjacent.  Color  is  determined 
by  any  four  adjacent  dots  along  a  line.  Think  of  a  four-dot-wide 
window  moving  across  the  screen:  at  any  given  time,  the  color 
displayed  corresponds  to  the  4-bit  value  from  Table  5-6  that 
corresponds  to  the  windov/s  position  (Figure  5-9).  Effective 
horizontal  resolution  with  color  is  140  (560  divided  by  4). 

Table  5-6  describes  the  data  values  used  to  produce  colors  in 
double  high-resolution  graphics.  To  use  the  table,  divide  the 
column  number  by  four  and  use  the  remainder  to  find  the  correct 
column:  abO  is  a  byte  residing  in  auxiliary  memory  corresponding 
to  a  remainder  of  0  Obyte  0,  4,  8,  and  so  on),  mbl  is  a  byte  residing 
in  main  memory  corresponding  to  a  remainder  of  1  (byte  1,  2,  9 
and  so  on),  and  similarly  for  ab2  and  mb3- 


Mixed-mode  displays 

Any  of  the  graphics  displays  can  have  four  lines  of  text,  either  40- 
column  or  80-column,  at  the  bottom  of  the  screen.  Graphics 
displays  with  text  at  the  bottom  are  called  mixed-mode  displays.  To 
use  them,  the  TEXT  switch  must  be  off  (read  $C050)  and  the  MIXED 
switch  on  (read  $C053). 


Important     You  cannot  display  40-column  text  wltti  double  tilgh-resoiution 
graphiics. 

To  determine  what  appears  where  in  mixed-mode  displays,  refer  to 
Figures  5-5  through  5-9  later  in  this  chapter.  See  the  bottom  sixth  of 
the  appropriate  text  display  (Figure  5-5  or  5-6)  and  the  upper  five- 
sixths  (down  to  the  heavy  horizontal  line)  in  the  appropriate 
graphics  display  (Figures  5-7  to  5-9). 
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Table  5-6 

Double  high-resolution  graphics  colors 


Repeated 

Color 

abO 

mbl 

ab2 

mb3 

bit  pattern 

Black 

$00 

$00 

$00 

$00 

0000 

Magenta 

$08 

$11 

$22 

$44 

0001 

Brown 

$44 

$08 

$11 

$22 

0010 

Orange 

$4C 

$19 

$33 

$66 

0011 

Dark  green 

$22 

$44 

$08 

$11 

0100 

Gray  1 

$2A 

$55 

$2A 

$55 

0101 

Green 

$66 

$4C 

$19 

$33 

0110 

Yellow 

$6e 

$5D 

$3B 

$77 

0111 

Dark  blue 

$11 

$22 

$44 

$08 

1000 

Purple 

$19 

$33 

$66 

$4C 

1001 

Gray  2 

$55 

$2A 

$55 

$2A 

1010 

Pink 

$5D 

$3B 

$77 

$6e 

1011 

Medium  blue 

$33 

$66 

$40 

$19 

1100 

Light  blue 

$3B 

$77 

$6e 

$5D 

1101 

Aqua 

$77 

$6E 

$5D 

$3B 

1110 

White 

•$7F 

$7F 

$7F 

$7F 

nil 

Note:  Colors  may  vary,  depending  on  adjustment  of  monitor  or  television 
set. 


Display  pages 

The  Apple  lie  uses  data  stored  in  specific  areas  in  memory  to 
generate  its  video  displays.  These  areas,  called  display  pages,  serve 
as  buffers  where  your  programs  can  put  data  to  be  displayed.  Each 
byte  in  a  display  buffer  controls  an  object — a  character,  a  colored 
block,  or  a  group  of  adjacent  dots — ^at  a  certain  location  on  the 
display,  depending  on  the  current  display  mode. 
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The  40-column-text  and  low-resolution-graphics  modes  use  two 
display  pages  of  1024  bytes  each.  These  are  called  text  Page  1  and 
text  Page  2,  and  they  are  located  at  $0400  through  $07FF  and  $0800 
through  $OBFF  in  main  memory.  Normally,  only  Page  1  is  used,  but 
you  can  put  text  or  graphics  data  into  Page  2  and  switch  between 
displays.  Either  page  can  be  displayed  as  40-colunin  text,  low- 
resolution  graphics,  or  mixed-mode  (four  lines  of  text  at  the 
bottom  of  a  graphics  display). 

The  80-column  text  mode  displays  twice  as  much  data  as  the  40- 
column  mode — 1920  bytes — but  it  cannot  switch  pages  when  the 
enhanced  video  firmware  is  active.  The  80-column  text  display  uses 
a  combination  page  made  up  of  text  Page  1  in  main  memory  plus 
another  page  in  auxiliary  memory.  This  additional  memory  is  not 
the  same  as  text  Page  2 — in  fact,  it  is  text  Page  IX,  and  it  occupies 
the  same  address  space  as  text  Page  1  (see  Figure  2-11).  The  built-in 
firmware  I/O  routines  descnised  in  Chapter  3  take  care  of  this  extra 
addressing  automatically,  that  is  one  reason  to  use  these  routines 
for  all  normal  text  output. 

Important     The  built-in  video  firmware  aiways  displays  Page  1  text.  You 
cannot  write  text  to  Page  2  witti  thie  built-in  firmware. 

The  high-resolution  graphics  mode  also  has  two  display  pages,  but 
each  page  is  8192  bytes  long.  In  the  40-column  text  and  low- 
resolution  graphics  modes  each  byte  controls  a  display  area  seven 
dots  wide  by  eight  dots  high.  In  high-resolution  graphics  mode 
each  byte  controls  an  area  seven  dots  wide  by  one  dot  high.  Thus,  a 
high-resolution  display  requires  eight  times  as  much  data  storage  as 
a  low-resolution  display,  as  shown  in  Table  5-7. 

The  double  high-resolution  graphics  mode  interleaves  the  two 
high-resolution  pages  (Pages  1  and  IX)  in  exactly  the  same  way  as 
80-column  text  mode  interleaves  the  text  pages:  column  0  and  all 
subsequent  even-numbered  columns  come  from  the  auxiliary  page; 
column  1  and  all  subsequent  odd-numbered  columns  come  from 
the  main  page. 
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Table  5-7 

Video  display  page 

locations 

Display  mods 

Display 
page 

Lowest  address 

Highest  address 

40-column  text, 

low-resolution 

graphics 

1 
2* 

$0400  1024 
$0800  2048 

$07FF  2047 
$OBFF  3071 

80-column  text 

1 
2* 

$0400  1024 
$0800  2048 

$07FF  2047 
$ObFF  3071 

High-resolution 
graphics 

1 
2 

$2000  8192 
$4000  16384 

$3FFF  16385 
$5FFF  24575 

Double  high- 
resolution 
graphics 

It 
2t 

$2000  8192 
$4000  6384 

$3FFF  16383 
$5FFF  24575 

•  This  is  not  supported  by  firmware;  for  instructions  on  how  to  switch 

pages,  refer  to  "Display  Mode  Switching." 
t  See  "Double  High-Resolution  Graphics." 


Display  mode  switching 

Table  5-8  shows  the  reserved  locations  for  the  soft  switches  that 
control  the  different  display  modes.  The  column  of  the  table 
labeled  Action  indicates  what  to  do  to  activate  or  read  a  switch 
setting:  J?  means  read  the  location,  W  means  write  anything  to  the 
location,  R/Wmezns  read  or  write,  and  i?7  means  read  the 
location  and  then  check  bit  7. 

Table  5-9  lists  the  display  modes  that  the  firmware  can  set  up 
automatically.  In  the  40-column  modes,  the  contents  of  the 
standard  I/O  hooks  KSW  and  CSW  (Chapter  3)  determine  whether 
the  enhanced  video  firmware  features  are  available  or  not.  The 
firmware  also  takes  care  of  setting  or  clearing  AltChar. 

Table  5-10  lists  other  display  modes  available  but  not  supported  by 
firmware.  For  modes  that  display  Page  2  with  the  80Col  switch  on, 
your  program  may  have  to  turn  SOStore  off  after  the  firmware  has 
turned  it  on. 

Double  low-resolution  shows  on  the  display  screen  when  HiRes  is 
off  and  both  80Col  and  DHiRes  are  on.  It  is  the  low-resolution 
graphics  equivalent  of  80-column  text,  and  it  uses  the  same  map 
(Figure  5-6),  giving  you  48  rows  of  80  blocks. 
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The  lOUDis  ($C07E)  switch  must  be  on  to  allow  you  to  use  locations 
$C05E  and  $C05F  to  change  DHiRes.  The  firmware  in  fact  leaves  it 
on — ^and  your  program  should,  too — unless  it  wants  to  use  locations 
$C05E  and  $C05F  to  change  mouse  values  (Chapter  9). 

Table  5-8 

Display  soft  switches 


Nam« 


Acflon 


Hex 


Function 


AltChar  W  $CO0E        Off:  Display  text  using 

primary  character  set 

AltChar  W  $COOF        On:  Display  text  using 

alternate  character  set 

Read  AltChar  switch  (1  =  on) 

Off:  Display  40  columns 

On:  Display  80  columns 

Read  80Col  switch  (1  =  on) 

Off:  Cause  Page2  on  to  select 
auxiliary  RAM 

SOStore  W  $C001         On:  Allow  Page2  to  switch 

main  RAM  areas 


RdAltChar 

R7 

$C01E 

80Col 

W 

$C00C 

SOCol 

W 

$C00D 

RdSOCol 

R7 

$C01F 

SOStore 

W 

$C000 

RdSOStore 

R7 

$C018 

Read  80Store  switch  (1  =  on) 

Page2 

R/W 

$C054 

Off:  Select  Page  1 

Page2 

R/W 

$C055 

On:  Select  Page  IX  (SOStore 
on)  or  2 

RdPage2 

R7 

$C01C 

Read  Page2  switch  (1  =  on) 

TEXT 

R/W 

$C050 

Off:  Display  graphics  or  (if 
MIXED  on)  mixed 

TEXT 

R/W 

$C051 

On:  Display  text 

RdTEXT 

R7 

$C01A 

Read  TEXT  switch  (1  =  on) 

MIXED 

R/W 

$C053 

Off:  Display  only  text  or  only 
graphics 
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Table  5-8  (continued) 
Display  soft  switches 


Name 


Action 


Hex 


Function 


RdMIXED         R7 
HiRes  R/W 


MIXED  R/W  $C054         On:  Of  TEXT  off)  display  text 

and  graphics 

$C01B       Read  MIXED  switch  (1  =  on) 

$C057        Off:  Of  TEXT  off)  display 
low-resolution  graphics 

HiRes  R/W  $C058        On:  (If  TEXT  off)  display 

high-resolution  or  (if  DHiRes 
on)  double  high-resolution 
graphics 

RdHiRes  R7  $C01D       Read  HiRes  switch  (1  =  on) 


lOUDis  W  $C07E        On:  Disable  lOU  access  for 

addresses  $C058  to  $C05F; 
enable  access  to  DHiRes 
switch 

lOUDis  W  $C07F        Off:  Enable  lOU  access  for 

addresses  $C058  to  $C05F; 
disable  access  to  DHiRes 
switch* 

RdlOUDis         R7  $C07E        Read  lOUDis  switch  (1  =  off)t 

DHiRes  R/W  $C05E        On:  (If  lOUDis  on)  turn  on 

double  high-resolution 

DHiRes  R/W  $C05F        Off:  Of  lOUDis  on)  turn  off 

double  high-resolution 

RdDHiRes        R7  $C07F        Read  DHiRes  switch  (1  =  on)t 

•  The  firmware  normally  leaves  lOUDis  on.  See  also  the  following 

footnote, 
t  Reading  or  writing  any  address  in  the  range  $C070-$C07F  also  triggers 

the  paddle  timer  and  resets  VBLInt  (Chapter  9). 
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Table  5-9 

Display  modes  supported  by  firmware.  Including  Applesoft 


Display 

Switches 

col/res 

Type 

Page 

8OC0I 

eostore 

Page2 

TEXT 

MIXED 

HiRes 

DHIRes 

40-column 

Text 

Off 

Off 

On 

Off 

Off 

Off 

SO-column 

Text 

On 

• 

On 

Low-res 

Graphics 

Off 

Off 

Off 

Off 

Off 

Off 

40/low 

Mixed 

Off 

Off 

Off 

On 

Off 

so/low 

Mixed 

On 

* 

Off 

Off 

On 

Off 

Off 

Hi-res 

Graphics 

Off 

Off 

Off 

Off 

On 

Hi-res 

Graphics 

Off 

On 

Off 

Off 

On 

40/high 

Mixed 

Off 

Off 

Off 

On 

On 

80/high 

Mixed 

On 

* 

Off 

Off 

On 

On 

Off 

•  SOStore  is  set 

by  the  firmware  when  8OC0I  is 

turned  on. 

Table  5-10 

Other  display  modes 

Display 

Switches 

coi/res 

Type 

Page 

8OC0I 

80Store 

Page2 

TEXT 

MIXED 

HIRes 

DHIRes 

40-column 

Text 

2 

Off 

On 

On 

80-column 

2 

On 

Off 

On 

On 

Low-res 

Graphics 

2 

Off 

On 

Off 

Off 

Off 

40/low 

Mixed 

2 

Off 

On 

Off 

On 

Off 

80/low 

Mixed 

2 

On 

Off 

On 

Off 

On 

Off 

Off 

Dbl-low 

Graphics 

1 

On 

* 

Off 

Off 

Off 

Off 

On 

Dbl-low 

Graphics 

2 

On 

Off 

On 

Off 

Off 

Off 

On 

80/dbl-low 

Mixed 

1 

On 

* 

Off 

Off 

On 

Off 

On 

80/dbl-low 

Mixed 

2 

On 

Off 

On 

Off 

On 

Off 

On 

40/high 

Mixed 

2 

Off 

On 

Off 

On 

On 

80/high 

Mixed 

2 

On 

Off 

On 

Off 

On 

On 

Off 

Dbl-high 

Graphics 

1 

On 

* 

Off 

Off 

Off 

On 

On 

Dbl-high 

Graphics 

2 

On 

Off 

On 

Off 

Off 

On 

On 

80/dbl-high 

Mixed 

1 

On 

* 

Off 

Off 

On 

On 

On 

80/dbl-high 

Mixed 

2 

On 

Off 

On 

Off 

On 

On 

On 

•  SOStore  is  set  by  the  firmware  when  8OC0I  is  turned  on,  and  must  he  turned  off  to  use  the  second  80-column 
or  double  high-resolution  page.  This  means  that  you  cannot  use  firmware  routines  such  as  COut  when 
displaying  Page  2  modes  not  supported  by  firmware. 
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STA 

$COOD 

LDA 

$C054 

STA 

$C050 

STA 

$C053 

STA 

$C057 

STA 

$C07E 

LDA 

$C05E 

For  example,  to  switch  to  mixed  80-column  and  double  high- 
resolution  display  Page  1,  you  can  use  these  instmctions  in  your 
program: 

Turns  on  8OC0I;  firmware  then  turns  on  SOStore. 
Turns  off  Page2;  you  could  also  have  done  a  STA. 
Turns  off  TEXT;  that  is,  turns  on  graphics  mode. 
Turns  on  MIXED;  it  works  now  that  TEXT  is  off. 
Turns  on  HiRes;  it  works  now  that  TEXT  is  off. 
Makes  sure  lOUDis  is  on  so  you  can  access  DHiRes. 
Turns  on  DHiRes;  it  works  now  that  lOUDis  is  on. 


Display  page  maps 

You  should  never  have  to  store  directly  into  display  memory.  Most 
high-level  languages  let  you  write  statements  that  control  the  text 
and  graphics  displays.  Similarly,  if  you  are  programming  in 
assembly  language,  you  should  use  the  display  features  of  the  built- 
in  I/O  firmware. 


Warning      Never  call  any  firmware  with  8OC0I  on  or  witin  SOStore  and 
Page2  botli  on.  If  you  do,  tlie  firmware  will  not  function 
properly.  As  a  general  rule,  always  leave  Page2  off, 

All  the  different  display  modes  use  the  same  basic  addressing 
scheme:  characters  or  graphics  bytes  are  stored  as  rows  of 
40  contiguous  bytes,  but  the  rows  themselves  are  not  stored  at 
locations  corresponding  to  their  locations  on  the  display.  Instead, 
the  display  address  is  transformed  so  that  three  rows  liat  are  eight 
rows  apart  on  the  display  are  grouped  together  and  stored  in  the 
first  120  locations  of  each  block  of  128  bytes  ($80  hex).  For 
example,  the  first  128-byte  block  contains  the  data  for  rows  0,  8, 
and  16.  The  next  128-byte  block  contains  data  for  rows  1,  9,  and  17, 
and  so  on. 

The  display  memory  maps  are  shown  in  Figures  5-5  through  5-9. 
For  a  full  description  of  the  way  the  Apple  lie  hardware  handles 
display  memory,  see  Chapter  11. 
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For  more  details  about  the  way 
the  displays  are  generated,  see 
Chapter  11. 


High-resolution  graphics  data  are  stored  in  much  the  same  way  as 
text,  but  there  are  eight  times  as  many  bytes  to  store,  because  eight 
rows  of  dots  occupy  the  same  space  on  the  display  as  one  row  of 
characters. 

The  first  1024  bytes  of  the  high-resolution  display  page  contain  the 
first  row  of  dots  from  each  of  the  24  groups  of  eight  rows  of  dots. 
The  second  1024  bytes  of  the  high-resolution  display  page  contain 
the  second  row  of  dots  from  each  group  of  eight  rows  of  dots,  and 
so  on  for  all  eight  rows  of  all  the  groups.  This  fills  up  the  8192  bytes 
of  the  high-resolution  display  page. 

The  display  maps  show  addresses  only  for  each  Page  1.  To  obtain 
addresses  for  text  or  low-resolution  graphics  Page  2,  add  1024 
($0400);  to  obtain  addresses  for  high-resolution  Page  2,  add  8192 
($2000). 

The  80-column  display  works  a  little  differently.  Half  of  the  data  are 
stored  in  the  normal  text  Page  1  memory,  and  the  other  half  are 
stored  in  the  auxiliary  memory  text  Page  1.  The  display  circuitry 
fetches  bytes  from  the  same  address  in  both  memory  areas 
simultaneously  and  displays  them  sequentially:  first  the  byte  from 
the  auxiliary  memory,  then  the  byte  from  the  main  memory.  The 
characters  in  the  even-numbered  columns  of  the  display  are  stored 
(starting  with  column  0)  in  main  memory,  and  the  characters  in  the 
odd-numbered  colunuis  of  the  display  are  stored  (starting  with 
column  1)  in  main  memory. 

To  store  display  data  in  auxiliary  memory,  first  turn  on  the  SOStore 
soft  switch  by  writing  to  location  $C001.  With  SOStore  on,  the  page- 
select  switch  Page2  selects  between  the  portion  of  the  80-colunin 
display  stored  in  Page  1  of  main  memory  and  the  portion  stored  in 
the  auxiliary  memory.  To  select  auxiliary  memory,  turn  the  Page2 
soft  switch  on  by  reading  or  writing  at  location  $C055. 

The  double  high-resolution  graphics  display  stores  information  in 
the  same  way  as  high-resolution  graphics,  except  there  is  an 
auxiliary  memory  location  as  well  as  a  main  memory  location 
corresponding  to  each  address.  The  two  sets  of  display  information 
are  interleaved  in  a  manner  similar  to  the  interleaving  of  two  40- 
column  displays  to  create  an  80-column  text  display  (Figure  5-9). 
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Figure  5-5 

Map  of  40-column  text  display 
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Map  of  80-column  text  display 
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Map  of  low-resolution  grapfilcs  display 
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Figure  5-8 

Map  of  high-resolution  graphics  display 
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Vlap  of  double  high-resolution  graphics  display 
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Monitor  support  for  video  display  output 

Table  5-11  summarizes  the  addresses  and  functions  of  the  video 
display  support  routines  the  Monitor  provides.  Except  for  COut  and 
COutl,  which  are  explained  in  Chapter  3,  these  routines  are 
described  in  the  subsections  that  follow. 

Table  5-11 

Monitor  firmware  routines 


Nam* 


Location         Description 


ClrEOL        $FC9C 


CIEOLZ        $FC9E 


ClrEOP 

$FC42 

ClrScr 

F832 

ClrTop 

$F836 

COut 

$FDED 

COutl 


$FDFO 


CROut  $FD8E 

CROutl  $FD8B 

HLine  $F819 

HOME  $FC58 

PLOT  $F800 

PrB12  $F94A 

PrByte  $FDDA 

PrErr  $FF2D 


PrHex 


$FDE3 


Clears  to  end  of  line  from  current  cursor 
position 

Clears  to  end  of  line  using  contents  of 
Y  register  as  cursor  position 

Clears  to  bottom  of  window 

Clears  the  low-resolution  screen 

Clears  top  40  lines  of  low-resolution  screen 

Calls  output  routine  whose  address  is 
stored  in  CSW  (normally  COutl, 
Chapter  3) 

Displays  a  character  on  the  screen 
(Chapter  3) 

Generates  a  carriage  return  character 

Clears  to  end  of  line,  then  generates  a 
carriage  return  character 

Draws  a  horizontal  line  of  blocks 

Clears  the  window  and  puts  cursor  in 
upper-left  corner  of  window 

Plots  a  single  low-resolution  block  on  the 
screen 

Sends  1  to  256  blank  spaces  to  the  output 
device  whose  address  is  in  CSW 

Prints  a  hexadecimal  byte 

Sends  ERR  and  Control-G  to  the  output 
device  whose  output  routine  address  is  in 
CSW 

Prints  four  bits  as  a  hexadecimal  number 
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Table  5-11  (continued) 
Monitor  firmware  routines 


Name 


Location        Description 


PrntAX 

$F941 

SCRN 

$F871 

SetCol 

$F864 

VTabZ 

$FC24 

VLine 


ClrEOL 


$F828 


Prints  contents  of  A  and  X  in  hexadecimal 

Reads  color  value  of  a  low  resolution  block 
on  the  screen 

Sets  the  color  for  plotting  in  low  resolution 

Sets  cursor  vertical  position  (setting  CV  at 
location  $25  does  not  change  vertical 
position  until  a  carriage  return) 

Draws  a  vertical  line  of  low-resolution 
blocks 


ClrEOL  clears  a  text  line  from  the  cursor  position  to  the  right  edge 
of  the  window.  This  routine  destroys  the  contents  of  A  and  Y. 

CIEOLZ 

C1EOL2  dears  a  text  line  to  the  right  edge  of  the  window,  starting  at 
the  location  given  by  base  address  BASL  indexed  by  the  contents  of 
the  Y  register.  This  routine  destroys  the  contents  of  A  and  Y. 

ClrEOP 

ClrEOP  dears  the  text  window  from  the  cursor  position  to  the 
bottom  of  the  window.  This  routine  destroys  the  contents  of  A 
and  Y. 

ClrScr 

ClrSa  dears  the  low-resolution  graphics  display  to  black.  If  you  call 
this  routine  while  the  video  display  is  in  text  mode,  it  fills  the  screen 
with  inverse-mode  at-sign  (@)  characters.  This  routine  destroys  the 
contents  of  A  and  Y. 

ClrTop 

ClrTop  is  the  same  as  ClrScr,  except  that  it  clears  only  the  top 
40  rows  of  the  low-resolution  display. 

COut 

COut  calls  the  current  character  output  subroutine.  The  character  to 
be  sent  to  the  output  device  should  be  in  the  accumulator.  COut 
calls  the  subroutine  whose  address  is  stored  in  CSW  Oocations  $36 
and  $37),  usually  the  standard  character  output  COutl. 
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COutl 

COutl  displays  the  character  in  the  accumulator  on  the  display 
screen  at  the  current  cursor  position  and  advances  the  cursor.  It 
places  the  character  using  the  setting  of  the  inverse  mask 
Oocation  $32).  It  handles  these  control  characters:  carriage  return, 
line  feed,  backspace,  and  bell.  When  it  returns  control  to  the 
calling  program,  all  registers  are  intact. 

CROut 

CROut  sends  a  carriage  return  to  the  current  output  device. 

CROutl 

CROutl  clears  the  screen  from  the  current  cursor  position  to  the 
edge  of  the  text  window,  then  calls  CROuL 

HLlne 

HLine  draws  a  horizontal  line  of  blocks  of  the  color  set  by  SetCol  on 
the  low-resolution  graphics  display.  Call  HLine  with  the  vertical 
coordinate  of  the  line  in  the  accumulator,  the  leftmost  horizontal 
coordinate  in  the  Y  register,  and  the  rightmost  horizontal 
coordinate  in  location  $2C.  HLine  returns  with  A  and  Y  scrambled 
and  X  intact. 

HOME 

HOME  clears  the  display  and  puts  the  cursor  in  the  upper-left 
corner  of  the  screen. 

PLOT 

PLOT  puts  a  single  block  of  the  color  value  set  by  SetCol  on  the  low- 
resolution  display  screen.  Call  PLOT  with  the  vertical  coordinate  of 
the  line  in  the  accumulator,  and  its  horizontal  position  in  the 
Y  register.  PLOT  returns  with  the  accumulator  scrambled,  but  X 
and  Y  intact. 

PrBl2 

PrBlZ  sends  from  1  to  256  blanks  to  the  standard  output  device. 
Upon  entry,  the  X  register  should  contain  the  number  of  blanks  to 
send.  If  X  =  $00,  then  PrBlank  will  send  256  blanks. 
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PrByte 

PrByte  sends  the  contents  of  the  accumulator  in  hexadecimal  to  the 
current  output  device.  The  contents  of  the  accumulator  are 
scrambled. 

PrErr 

PrErr  sends  the  word  ERR,  followed  by  a  bell  character  (ASCII  $07), 
to  the  standard  output  device.  On  return,  the  accumulator  is 
scrambled. 

FrHex 

PrHex  prints  the  lower  nibble  of  the  byte  in  the  accumulator  as  a 
single  hexadecimal  digit  On  return,  the  contents  of  the 
accumulator  are  scrambled. 

PrntAX 

PrntAX  prints  the  contents  of  the  A  and  X  registers  as  a  four-digit 
hexadecimal  value.  The  accumulator  contains  the  first  byte  printed, 
and  the  X  register  contains  the  second.  On  return,  the  contents  of 
the  accumulator  are  scrambled. 

SCRN 

SCRN  returns  the  color  value  of  a  single  block  on  the  low-resolution 
display.  Call  it  with  the  vertical  position  of  the  block  in  the 
accumulator  and  the  horizontal  position  in  the  Y  register.  The 
block's  color  is  returned  in  the  accumulator.  No  other  registers  are 
changed. 

SetCol 

SetCol  sets  the  color  used  for  plotting  in  low-resolution  graphics  to 
the  value  passed  in  the  accumulator.  The  colors  and  their  values  are 
listed  in  Table  5-4. 

VLine 

VLine  draws  a  vertical  line  of  blocks  of  the  color  set  by  SetCol  on  the 
low-resolution  display.  Call  VLine  with  the  horizontal  coordinate  of 
the  line  in  the  Y  register,  the  top  vertical  coordinate  in  the 
accumulator,  and  the  bottom  vertical  coordinate  in  location  $2D. 
VLine  returns  with  the  accumulator  scrambled. 
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I/O  firmware  support 
for  video  display  output 

Apple  lie  video  firmware  conforms  to  the  I/O  firmware  protocol 
described  in  Chapter  3.  However,  it  does  not  support  windows 
other  than  the  full  80-by-24  window  in  80-column  mode,  and  the 
full  40-by-24  window  in  40-column  mode. 

The  video  (port  3)  protocol  table  is  shown  in  Table  5-12. 

Table  5-12 

Port  3  firmware  protocol  table 

Address     Value     Description 


$C30B 

$01 

$C30C 

$88 

$C30D 

$ii 

$C30E 

$rr 

$C30F 

$ww 

$C310 

$ss 

Generic  signature  byte  of  firmware  cards 
80-column  card  device  signature 
$C3ii  is  entry  point  of  initialization  routine  OPInit) 
$C3rr  is  entry  point  of  read  routine  (PRead) 
$C3ww  is  entry  point  of  write  routine  (PWrite) 
$C3ss  is  entry  point  of  the  status  routine  (PStatus). 


PInIt 

PInit  does  the  following: 

D  sets  a  full  80-column  window 

D  sets  BOStore  ($C001) 

n  sets  80Col  C$C00D) 

D  switches  on  AltChar  ($C00F) 

D  dears  the  screen;  places  cursor  in  upper-left  corner 

D  displays  the  cursor 

PRead 

PRead  reads  a  character  from  the  keyboard  and  places  it  in  the 
accumulator  with  the  high  bit  cleared.  It  also  puts  a  0  in  the 
X  register  to  indicate  lOResult  =  GOOD. 
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PWrite 

PWrite  should  be  called  after  placing  a  character  in  the  accumulator 
with  its  high  bit  cleared.  PWrite  does  the  following: 

n  turns  the  cursor  off 

n  if  the  character  in  the  accumulator  is  not  a  control  character, 
turns  the  high  bit  on  for  normal  display  or  off  for  inverse  display, 
displays  it  at  the  current  cursor  position,  and  advances  the 
cursor;  if  at  the  end  of  a  line,  does  carriage  return  but  not  line 
feed 

D  carries  out  control  functions  as  shown  in  Table  5-13 

Table  5-13 

Pascal  video  control  functions 

Control-       Hex        Function 

E  or  e         $05        Turns  cursor  on  (eiubles  cursor  display) 

F  or  f         $06        Turns  cursor  off  (disables  cursor  display) 

G  or  g        $07        Sounds  bell  (beeps) 

H  or  h  $08  Moves  cursor  left  one  column;  if  cursor  was  at 
beginning  of  line,  moves  it  to  end  of  previous 
line 

J  or  j  $0A        Moves  cursor  down  one  row;  scrolls  if  needed 

K  or  k         $0B        Clears  to  end  of  screen 

L  or  1  $0C        Clears  screen;  moves  cursor  to  upper-left 

position  on  screen 

M  or  m       $0D        Moves  cursor  to  column  0 

N  or  n        $0E        Displays  subsequent  characters  in  normal 
video;  characters  already  on  display  are 
unaffected 

O  or  o        $0F         Displays  subsequent  characters  in  inverse 
video;  characters  already  on  display  are 
unaffected 

V  or  V         $l6         Scrolls  screen  up  one  line;  dears  bottom  line 
Worw       $17         Scrolls  screen  down  one  line;  clears  top  line 

Y  or  y         $19         Moves  cursor  to  upper-left  (home)  position  on 

screen 

2  or  z         $  1 A        Clears  entire  line  that  cursor  is  on 
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Table  5-13  (continued) 
Pascal  video  control  functions 


Control-       Hex        Function 


I  or  \         $1C        Moves  cursor  right  one  column;  if  at  end  of 
line,  does  Control-M 

}  or  ]  $1D        Clears  to  end  of  the  line  the  cursor  is  on, 

including  current  cursor  position;  does  not 
move  cursor 

A  or  6         $1E        GOTOxy:  Initiates  a  GOTOxy  sequence; 

interprets  the  next  two  characters  as  x+32  and 
y+32,  respectively 

_  $1F         If  not  at  top  of  screen,  moves  cursor  up  one  line 

When  PWrite  has  completed  this,  it 

n  turns  the  cursor  back  on  (if  it  was  not  intentionally  turned  ofD 

D  puts  a  0  in  the  X  register  (lOResult  =  GOOD)  and  returns  to  the 
calling  program 

PStatus 

A  program  that  calls  PStatus  must  first  put  a  request  code  in  the 
accumulator:  either  a  0  (meaning  "Ready  for  output'")  or  a  1 
(meaning  "Is  there  any  input'").  PStatus  returns  with  the  reply  in  the 
carry  bit:  0  (no)  or  1  (yes).  If  the  request  was  not  0  or  1,  PStatus 
returns  with  a  3  in  the  X  register  OOResult  =  ILLEGAL 
OPERATIO>D;  otherwise,  PStatus  returns  with  a  0  in  the  X  register 
OOResult  =  GOOD). 
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A  block-type  device,  or  block 
device,  executes  I/O  operations 
by  grouping  date  Into  bundles, 
called  blocks.  A  block  may  be 
made  up  of  virtually  any  number 
of  bytes,  but  In  the  Apple  lie  a 
standard  block  is  512  bytes. 


The  Apple  lie  supports  both  built-in  and  external  block-type 
devices.  External  block  devices  may  be  5.25-inch  Disk  lie  drives, 
UniDisk  3.5-ineh  disk  drives,  a  memory  expansion  card,  and  other 
similar  devices.  If  you  use  a  5.25-inch  Disk  lie  as  an  external  drive, 
you  must  install  it  as  the  last  device  in  the  daisy  chain. 


Original  lie     The  original  Apple  lie  does  not  support  devices  othier  than  its 
internal  5.25-inch  disk  drive  and  an  (optional)  external 
5.25-inch  Disk  lie  drive. 

The  external  block  device  interface  is  provided  by  the  Smartport 
firmware.  The  Smartport  is  described  later  in  this  chapter. 


UniDisk  3.5     The  UnlDisk  3.5  ROIVI  contains  an  older  version  of  the  Smartport, 
the  Protocol  Converter.  The  description  of  the  Smartport  applies 
to  the  Protocol  Converter,  and  vice  versa. 


The  external  disk  drive 
connector  Is  described  under 
"Disk  I/O"  In  Chapter  11. 


Disk  drive  I/O 

Disk  I/O  firmware  for  the  5.25-inch  drives  resides  in  the  $C600 
address  space  on  the  main  side  of  the  ROM.  The  built-in  5.25-inch 
drive  is  supported  as  if  it  were  slot  6,  drive  1,  and  the  external 
5.25-ineh  drive  as  if  it  were  slot  6,  drive  2. 

Disk  I/O  firmware  for  the  UniDisk  3.5  drive  resides  in  the 
$C500-$C58D  address  space  on  the  main  side,  and  in  the 
$C880-$CFFF  address  space  on  the  auxiliary  side  of  the  ROM. 

Table  6-1  summarizes  the  disk  I/O  port  characteristics. 

Table  6-1 

Disk  I/O  port  characteristics 


Port  number 


Commands 


Initial  ctiaracteristlcs 


I/O  port  6  drive  1  (built-in  5.25-inch  drive). 
I/O  port  6  drive  2  (external  5.25-inch 
drive).  I/O  port  5  drive  1  (external  3.5-inch 
drive). 

IN#6  or  PR#6  CALL  -151  (to  get  to  the 
Monitor  from  BASIC),  then  6  Control-K  or 
6  Control-P. 

All  resets  except  Control-Reset  with  a  valid 
reset  vector  eventually  pass  control  to  the 
built-in  disk  drive. 
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Table  6-1  (continued) 

Disk  I/O  port  characteristics 


Hardware  location 

$COEO-EF 

Reserved. 

Monitor  firmware 
routines 

None. 

I/O  firmware 
entry  points 

$C600  (port  6) 

Use  of  screen  holes  Port  6  main  and  auxiliary  memory  screen 

holes  are  reserved. 


Startup 

The  Apple  lie  has  two  ways  to  start  up — a  cold  start  and  a  warm  start. 
A  cold  start  dears  the  machine's  memory  and  tries  to  load  an 
operating  system  from  disk.  A  warm  start  halts  the  program  that  is 
running  and  leaves  the  machine  in  Applesoft  with  the  contents  of 
memory  intact. 


Cold  start 

A  cold  start  can  be  initiated  by  any  of  the  following: 

n  turning  the  machine  on 

D  pressing  Open  Apple-Control-Reset 

n  issuing  a  reboot  command  from  the  Monitor,  BASIC,  or  a 
program 

D  pressing  Control-Reset,  if  a  valid  reset  vector  does  not  exist 

The  startup  routine  first  sets  a  number  of  soft  switches  to  their 
initialization  settings  (see  Chapter  2)  and  then  passes  control  to  the 
memory  expansion  card  I/O  entry  point  at  $C400.  Because  the 
contents  of  the  memory  expansion  card's  RAM  are  invalid  in  all 
cold-start  situations,  the  Apple  lie  cannot  boot  from  card  and 
control  is  returned  to  the  startup  routine. 


Original  lie     The  original  Apple  lie  does  not  support  the  memory  expansion 
card;  the  restart  routine  in  the  original  lie  begins  with  the 
internal  5.25-inch  drive. 
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When  control  is  returned  to  the  startup  routine  by  the  memory 
expansion  card,  it  will  attempt  to  boot  the  Apple  lie  from  the 
internal  5.25-inch  drive.  Control  is  passed  to  the  5.25-inch  disk  I/O 
entry  point  at  $C600.  The  code  at  this  address  turns  on  the  internal 
drive  motor,  recalibrates  the  read/write  head  at  track  0,  then  reads 
sector  0  from  that  track.  The  sector  contents  are  loaded  into  main 
memory,  starting  at  address  $0800.  Once  the  contents  of  sector  0 
have  been  loaded  into  main  memory,  control  passes  to  $0801.  The 
program  loaded  depends  on  the  operating  system  or  application 
program  on  the  disk  in  internal  drive. 

If  for  any  reason  the  Apple  lie  is  unable  to  boot  from  the  internal 
drive,  control  is  returned  to  the  startup  routine.  The  startup  routine 
then  attempts  to  boot  the  Apple  lie  from  the  external  UniDisk  35 
drive.  Control  is  passed  to  die  UniDisk  3.5  I/O  entry  point  at 
$C500,  and  the  startup  attempt  proceeds  in  the  same  manner  as  that 
of  the  internal  5.25-inch  drive. 

Original  iic     The  original  Apple  lie  does  not  support  \he  UnlDlsl<  3.5  drive. 
However,  it  is  possible  to  start  ttie  original  Apple  lie  from  the 
external  5.25-lneh  drive.  If  you  want  to  start  your  Apple  He  from 
the  external  5.25-ineh  drive,  you  must  use  the  ProDOS 
operating  system.  To  start  from  the  external  drive,  insert  a 
ProDOS  disk  in  the  drive  and 

D  From  the  Monitor,  type  call    -151  and  press  7  Controi-P. 

a  From  BASIC,  type  PR#7. 

To  force  a  cold  restart  of  the  system: 

D  From  BASIC,  issue  a  PR#6  command. 

D  From  the  Monitor,  issue  6  Control-P. 

n  From  a  machine-language  program,  JMP  $C600. 


Memory  expansion 


To  force  a  eold  restart  from  a  maehlne-language  program  In  on 
Apple  He  that  supports  the  memory  expansion  eard,  JMP  $C400 
(the  memory  expansion  eard  entry  point). 


UniDisk  3.5     The  Apple  He  that  supports  the  UnlDlsl<  3.5  ean  foree  a  eold 

restart  that  skips  the  Internal  5.25-ineh  drive  and  passes  control 
to  the  external  drive  port  at  $C500  entry  point.  This  allows  the 
system  to  start  up  from  the  first  Intelligent  drive  connected  to 
the  external  drive  port.  You  can  use  the  ProDOS  or  Pascal 
operating  system  If  you  want  to  start  the  system  from  an 
external  drive,  but  DOS  and  versions  of  Pascal  earlier  than  1.3 
will  not  work. 
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Warm  start 

A  warm  start  is  initiated  by  pressing  Control-Reset.  The  warm  start 
routine  checks  $F800-$FFFF  on  the  main  side  ROM  for  a  valid  reset 
vector.  Provided  a  valid  reset  vector  exists,  control  is  turned  over  to 
the  entry  point  specified  by  the  vector.  Generally,  a  warm  start 
leaves  you  in  BASIC  with  memory  unchanged. 

If  there  is  no  valid  reset  vector,  a  number  of  things  may  happen: 

D  The  Apple  lie  passes  control  to  $C600  on  the  main  side  ROM  and 
the  cold-start  boot  procedure  begins. 

n  The  Apple  lie  beeps. 

D  The  Apple  lie  does  nothing. 


Memory  expansion     In  the  Apple  He  that  supports  the  memory  expansion  card, 
control  Is  turned  over  to  $0400  on  the  main  side  ROIVI  In  the 
event  there  is  no  valid  reset  vector. 


Memory  expansion  card  I/O 

The  memory  expansion  card  provides  up  to  1Mb  of  RAM,  in  256K 
steps,  for  storage  of  program  and  data  files.  In  this  sense,  it  is  like  a 
very  fast  disk  drive.  Programs  can  be  loaded  into  the  memory 
expansion  card's  RAM,  but  in  order  to  be  executed  they  must  be 
moved,  in  whole  or  in  part,  to  the  Apple  He's  main  memory. 

The  memory  expansion  card  is  a  block-type  device,  so  I/O 
operations  involving  the  card  use  the  operating  system  or 
Smartport  I/O  interface.  The  Smartport  I/O  interface  is  described 
later  in  this  chapter. 

More  information  on  the  memory  expansion  card  can  be  found  in 
the  Apple  lie  Memory  Expansion  Card  Technical  Reference. 


Ttie  Smartport  I/O  interface 


important     The  rest  of  this  chapter  applies  only  to  the  UniDlsk  3.5  and 
memor/  expansion  versions  of  the  Apple  lie. 
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UniDisk  3.5     The  Smartport  and  the  Protocol  Converter  are  essentially  the 
same  firmware  interface  with  different  names.  Ail  the 
specifications  given  In  this  manual  for  the  Smartport  interface 
apply  to  the  Protocol  Converter  as  well. 

The  rest  of  this  chapter  is  about  the  Smartport,  which  is  a  set  of 
assembly-language  routines  used  to  support  external  I/O  devices, 
such  as  UniDisk  3.5.  To  ProDOS  and  Pascal  1.3,  the  Smartport 
appears  to  be  a  block  device. 

At  the  end  of  this  chapter  is  an  example  of  an  assembly-language 
program  that  uses  a  Smartport  call. 


Locating  the  Smartport 

The  Smartport  code  in  the  Apple  He's  firmware  always  begins  at 
address  $C500.  To  ensure  compatibility  of  your  programs  with  the 
Apple  He,  however,  your  Smartport  routines  should  always  begin 
with  a  search  for  the  Smartport.  Your  program  can  identify  the 
Smartport  by  finding  the  following  bytes: 

$Cn01=$20 
$Cn03=$00 
$Cn05=$03 
$Cn07=$00 

where  n  can  be  an  integer  from  1  to  7.  The  Smartport  entry  point  is 
then  found  at  address  $CnOO  +  ($CnFF)  +  3,  where  C$CnFF)  refers 
to  the  value  of  the  byte  located  at  $CnFF.  The  sample  program  at 
the  end  of  this  chapter  illustrates  such  a  search. 


Important     The  Smartport  firmware  Is  present  even  when  the  Memory 
Expansion  Card  Is  not.  To  check  for  the  Memory  Expansion 
Card,  issue  a  STATUS  call,  code  $03,  from  the  operating  system 
or  the  Smartport.  if  the  data  returned  Indicates  0  bytes 
available,  the  card  Is  not  present. 
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On  MU  calls,  see  the  ProDOS 
Technical  Reference  Manual, 
Chapter  4. 


Register 


Successful 
call 

Unsuccessful 
call 


Issuing  a  call  to  the  Smartport 

Smartport  calls  are  coded  like  ProDOS  Machine  Language  Interface 
(Mil)  calls:  the  program  executes  a  JSR  to  a  dispatch  routine  at 
address  $C500  +  ($C5FF)  +  3,  where  ($C5FF)  refers  to  the  value  of 
the  byte  located  at  $C5FF. 

The  Smartport  call  number  and  a  two-byte  pointer  to  the  call's 
parameter  list  must  immediately  follow  the  call.  Here  is  an  example 
of  a  call  to  the  Smartport: 


IWMCALL 
JSR   DISPATCH 
DFB  CmdNum 
DW     CmdList 
BCS   ERROR 


Calls  PC  command  dispatcher 

Specifies  the  command  typ)e 

2-byte  Oow,  high)  pointer  to  parameter  list 

Sets  carry  on  an  error 


The  command  number  (CmdNum)  defines  which  Smartport  call 
you  want  to  make.  Most  Smartport  calls  include  a  two-byte  pointer 
to  a  parameter  list.  The  parameter  list  can  contain  information  to 
be  used  by  the  call,  or  can  provide  space  for  information  to  be 
returned  by  the  call.  The  length  and  content  of  the  parameter  list 
depend  on  the  call  being  made.  The  format  of  each  Smartport  call's 
parameter  list  is  described  later  in  this  chapter. 

When  the  call  has  finished,  the  program  resumes  execution  at  the 
statement  following  the  pointer  to  the  parameter  list.  In  the 
example  above,  the  DFB  and  DW  statements  are  skipped  and 
execution  resumes  with  the  BCS  statement.  If  the  call  is  successful, 
the  C  flag  (in  the  processor  status  register)  is  cleared  (0),  and  the 
accumulator  (the  A  register)  is  cleared  to  all  O's.  If  the  call  is 
unsuccessful,  the  C  flag  is  set  (1)  and  the  error  code  is  placed  in  the 
A  register.  After  the  Smartport  call,  the  contents  of  the  65C02's 
registers  are  as  follows: 


Processor  status 


1 


u 


u 


0 


u 


u 


A  PC  S 

0  JSR+3        u 

Error        JSR+3        u 


X  =  undefined,  except  in  cases  where  index  information  is  returned  in  X  and  Y  registers 
u  =  unchanged 


Issuing  a  call  to  the  Smartport 
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On  reading  and  writing  to  l?AM, 
see  "Bank-Switclned  Memory" 
in  Chapter  4, 


Cautions 

You  must  observe  the  following  cautions  when  using  the  Smartport, 
or  your  program  will  crash: 

D  Leave  space  on  the  stack  for  the  Smartport  The  SmartpOrt 
requires  up  to  35  bytes  of  stack  space.  Be  sure  to  take  this  into 
account  when  calculating  the  stack  space  used  by  your  program. 
If  you  don't  do  this,  your  program  will  fail  if  it  tries  to  access  data 
that  used  to  be  on  the  stack. 

D  Be  sure  that  all  RAM  that  you  intend  the  Smartport  to  access  is 
both  read-enabled  and  write-enabled.  The  Smartport  must  be 
able  to  read  from  the  RAM  after  writing  to  it,  to  obtain  a 
checksum.  Failure  to  observe  this  rule  results  in  an  error 
(BusErr  $06). 

D  Don't  pass  data  to  or  from  the  Smartport  through  any  zero  page 
locations.  Some  of  these  locations  are  reserved  for  temporary 
storage  of  data  by  the  Smartport,  and  your  data  will  get  changed. 


Descriptions  of  the  Smartport  colls 

Calls  to  the  Smartport  are  used 

n  to  obtain  status  information  about  a  device 

D  to  reset  a  device 

n  to  format  the  medium  in  a  device 

n  to  read  from  a  device 

D  to  write  to  a  device 

D  to  send  control  information  to  a  device 

The  Smartport  calls,  in  command-number  sequence,  are 


STATUS  ($00) 


READ  BLOCK  ($01) 


Returns  status  information  about  a 
particular  device,  including  general  status 
(character  or  block  device,  read  or  write 
protection,  format  allowed,  device  on 
line);  the  device  control  block  (set  with 
the  CONTROL  call);  the  device  newline 
status  (character  devices  only);  and 
device-specific  information  (number  of 
blocks,  ID  string,  device  name,  device 
type,  device  firmware  version). 

Reads  one  512-byte  block  from  a  disk 
device,  and  writes  it  to  memory. 


126 


Chapter  6:  Block  Device  I/O 


WRITE  BLOCK  C$02) 


FORMAT  ($03) 


CONTROL  ($04) 


Writes  one  512-byte  block  from  memory 
to  a  disk  device. 

Prepares  all  blocks  on  a  block  device  for 
reading  and  writing. 

Controls  some  device  functions, 
including  soft  resets,  setting  the  device 
control  block  (which  controls  global 
aspects  of  the  device's  operating 
environment),  setting  newline  status 
(character  devices  only),  and  device 
interrupts.  Several  CONTROL  calls  are 
device-specific. 

Resets  all  resident  devices.  A  global  reset 
is  done  automatically  on  startup  or  system 
resets  from  the  keyboard;  an  application 
should  never  have  to  reset  all  devices. 

Prepares  a  character  device  for  reading  or 
writing. 

Tells  a  character  device  that  a  sequence  of 
reads  or  writes  is  over. 

Reads  a  specified  number  of  bytes  from  a 
specified  device. 

Writes  a  specified  number  of  bytes  from 
memory  to  a  specified  device. 

The  following  sections  describe  each  Smartport  call,  including  the 
command  number,  the  parameter  list,  and  error  codes.  The  calls 
are  discussed  in  command-number  order  in  this  format: 

Command  name:  The  name  used  to  identify  the  call. 

Command  number:  A  hexadecimal  number  that  specifies  which 
call  is  being  made  to  the  Smartport. 

Parameter  Ust:  A  list  of  required  call  parameters. 

General  description:  What  the  call  does  and  what  you  use  it  for. 

Parameter  descriptions:  A  description  of  each  parameter  and 
the  data  it  refers  to.  When  a  parameter  refers  to  a  status  or  control 
code,  the  meaning  of  each  code  number  is  discussed. 

Possible  errors:  A  list  of  the  error  codes  that  can  be  returned  by 
this  call.  A  complete  list  of  Smartport  error  codes  is  included  at  the 
end  of  this  chapter. 


INIT  ($05) 


OPEN  ($06) 


CLOSE  ($07) 


READ  ($08) 


WRITE  ($09) 


Descriptions  of  tlie  Smartport  caiis 
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STATUS 

Command         $00 
number 

Parametor        $03  (parameter  counO 
list  Unit  number 

Status  list  pointer  (low  byte,  high  byte) 

Status  code 

The  STATUS  call  returns  status  information  about  a  specified 
device.  The  type  of  information  returned  is  determined  by  the 
device  and  its  status-code  parameter.  The  status  list  pointer  defines 
where  the  status  information  is  returned  to. 

STATUS  returns  the  number  of  bytes  of  status  information  that  it 
generates  in  the  X  and  Y  registers,  the  low  byte  of  this  number  in 
the  X  register,  and  the  high  byte  in  the  Y  register. 


Parameter  descriptions 


Parameter 
count 

1-byte  value 

Unit  number 
1-byte  value 


Three  for  this  call. 

The  Smartport  assigns  each  device  a  unique  number 
during  Initialization  (on  startup  and  cold  reset). 
The  numbers  are  in  the  range  $01-$7E  and  are 
assigned  according  to  the  devices'  positions  in 
the  chain. 


Important     You  can  get  the  status  of  ttie  Smartport  itself  if  you  use  a  unit 
number  of  $00  and  a  status  code  of  $00  In  a  STATUS  call  (see  ttie 
discussion  beginning  "Status  code  =  $00,"  below). 
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status  list 
pointer 

2-byte  value 


Status  code 

1-byte  value 


Points  to  the  buffer  to  which  the  status  is  to  be 
returned.  The  length  required  for  the  buffer  varies 
depending  on  the  status  request  being  made. 

Indicates  what  kind  of  status  request  is  being  made. 
Status  codes  are  in  the  range  $00-$FF,  as  follows: 

Code        Status  returned 

$00  Return  device  status 

$01  Return  device  control  block  (DCB)  (not 

supported  by  UniDisk  3.5) 
$02  Return  newline  status  (character  devices 

only)  (not  supported  by  UniDisk  3.5) 
$03  Return  device  information  block  (DIB) 

$05  Return  UniDisk  3.5  status 

Status  code  =  $00  returns  a  device  status  consisting  of  four  bytes. 
The  first  is  the  general  status  byte,  with  the  following  format: 

Bit         Description 

7  0  =  character  device,  1  =  block  device 

6  1  =  write  allowed 

5  1  =  read  allowed 

4  1  =  device  on  line  or  disk  in  drive 

3  0  =  format  allowed 

2  0  =  medium  write  protected  (block  devices  only) 

1  1  =  device  currently  interrupting 

0  1  =  device  currently  open  (character  devices  only) 

If  the  STATUS  call  is  for  a  block  device,  the  next  three  bytes  Oow 
byte  first)  are  the  size  in  51 2-byte  blocks.  The  maximum  size  is 
16  million  ($FFFFFP)  blocks  (about  8  gigabytes).  If  the  call  is  for  a 
character  device,  these  three  bytes  must  be  set  to  0. 


Descriptions  of  the  Smartport  calis 
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A  STATUS  call  with  status  code  =  $00  and  unit  number  =  $00  returns 
the  status  of  the  Smartport  itself.  In  this  case,  the  status  list  consists 
of  8  bytes,  as  follows: 


STAT_LIST 

DFB 

Number 

_Devices 

Devices  boo 

ked  to  PC 

DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 

Interr 

upt_ 

_Status 

Bit  6  clear  = 

Reserved 

Reserved 

Reserved 

Reserved 

Reserved 

Reserved 

interrupt  sent 

On  newllne  read  mode,  see 
Chapter  4  In  the  ProDOS 
Technical  Reference  Manual. 


The  Number_Devices  byte  returns  the  total  number  of  intelligent 
devices  attached  to  the  Smartport.  The  Interrupt_Status  byte  is  a 
copy  of  the  asynchronous  communications  interface  adapter 
(ACIA)  status  register  at  the  time  of  the  interrupt,  and  is  used  to 
indicate  that  a  device  requires  interrupt  servicing.  If  the  sixth  bit  of 
this  byte  equals  0,  one  or  more  devices  in  the  Smartport  bus  daisy 
chain  must  be  serviced;  your  interrupt  handler  must  poll  each 
device  on  the  chain  to  determine  which  ones. 

♦  About  interrupts:  Devices  that  require  interrupt  servicing  must 
use  the  EXTINT  line  on  the  Apple  He's  external  disk  port 
connector  to  be  supported  by  the  Smartport. 

For  example,  UniDisk  3.5  does  not  support  this  line,  and  so 
cannot  generate  interrupts  to  the  Smartport.  See  the 
description  of  the  CONTROL  command  for  instructions  on 
enabling  Smartport  interrupts.  See  Appendix  E  for  more 
information  about  programming  with  interrupts. 

Status  code  =  $01  leturns  the  device  control  block  (DCB).  The 
DCB  is  used  to  control  various  operating  characteristics  of  a  device 
and  is  device  dependent.  Each  device  has  a  default  DCB,  which  can 
be  altered  with  a  CONTROL  call.  The  first  byte  (the  count  byte)  gives 
the  number  of  bytes  in  the  control  block  Cnot  including  the  count 
byte),  so  the  length  never  exceeds  256  bytes  (257  including  the 
count  byte).  Note  that  UniDisk  3.5  has  no  DCB  and  returns  an  error 
(BadCtl  $21)  in  response  to  this  call. 

Status  code  =  $02  returns  newline  status.  Newline  status  applies  only 
to  character  devices.  A  status  code  =  $02  passed  to  a  block  device 
returns  a  BadCtl  ($21)  error. 
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Status  code  =  $03  returns  the  device  information  block  (DIB).  The 
device's  information  block  identifies  the  device,  its  type,  and 
various  other  attributes.  The  returned  status  list  has  the  following 
form: 


STAT    LIST 


DFB  Device_StatbYtel 

DFB  Device_Size_Lo 

DFB  Device_Size_Med 

DFB  Device_Slze_Hi 

DFB  ID_String_Length 

ASC  ' <device  name>' 


DFB       Device_Type_Code 
DFB       Device_Subtype_Code 
DW         Version 


Same  as  byte  1  in  status 
code  =  0 

Number  of  blocks 
Oblock  device) 
Number  of  blocks 
(middle  byte) 
Number  of  blocks  (high 
byte) 

Length  in  bytes  (16  max.) 
7-bit  ASCII,  uppercase, 
padded  with  spaces,  8th 
bit  always=0  (16  bytes) 


Device  firmware  version 
number 


Status  code  =  $05  returns  the  UniDisk  3.5  status.  This  call  allows  a 
diagnostic  program  to  get  more  detailed  information  about  the 
cause  of  a  read  or  write  error,  and  to  examine  the  contents  of  the 
65C02's  registers  after  a  CONTROL  call  with  control  code  =  $05. 
The  returned  status  list  has  this  form: 


STAT    LIST 


DFB  $00 

DFB  Error 

DFB  Retries 

DFB  $00 

DFB  A_Value 

DFB  X_Value 

DFB  Y_Value 

DFB  P  Value 


Soft  Error  byte  (see  below) 
Number  of  retries  (see  below) 

Ace  value  after  a  CONTROL  EXECUTE 

call 

X  value  after  EXECUTE 

Y  value  after  EXECUTE 

Processor  status  value  after  EXECUTE 


Descriptions  of  the  Smartport  calls 
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The  Error  byte  returned  by  a  STATUS  call  with  status  code  =  $05 
contains  the  following  bits: 


Bit 

Description 

7 

0 

6 

0 

5 

1  =  address  field  mark  or  checksum  error 

4 

1  =  data  field  checksum  error 

3 

1  =  data  field  bitslip  mark  mismatch 

2 

1  =  seek  error;  unexpected  track  value  found 

in  address  field 

1 

0 

0 

0 

The  Retries  byte  returned  by  a  STATUS  call  with  status  code  =  $05 
specfies  the  number  of  address  fields  that  had  to  be  passed  before 
the  operation  was  completed.  This  information  could  be  used,  for 
example,  to  determine  the  number  of  passes  necessary  to  read  a 
data  field  correctly:  If  Retries  is  found  to  be  greater  than  the  number 
of  sectors  on  the  target  track,  then  more  than  one  pass  was  required. 

The  last  four  bytes  of  the  status  list  are  set  only  after  a  CONTROL  call 
with  control  code  =  $05,  and  are  0  after  any  other  call  (STATUS 
calls  do  not  dear  the  status  bytes). 


Possible  errors 

The  following  errors  can  be  returned  by  the  STATUS  call: 

An  unimplemented  command  was  issued 
Bad  call  parameter  count 
Communications  error 
Invalid  status  code 
Device-specific  errors 


$01 

BadCmd 

$04 

BadPCnt 

$06 

BusErr 

$21 

BadCtl 

$30-$3F 

READ  BLOCK 


Command 
number 

Parameter 
list 


$01 

$03  (parameter  count) 

$03  (parameter  count) 

Unit  number 

Data  buffer  Oow  byte,  high  byte) 

Block  number  Oow  byte,  mid  byte,  high  byte) 
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The  READ  BLOCK  call  reads  one  512-byte  block  into  memory  from 
the  block  device  specified  by  the  unit-number  parameter.  The  block 
of  data  is  placed  in  a  buffer  starting  at  the  address  specified  by  the 
data-buffer  parameter. 


Parameter  descriptions 


Parameter 
count 
1-byte  value 

Unit  number 
1-byte  value 


Data  buffer 
2-byte  value 

Block  number 
3-byte  value 


Three  for  this  call. 

The  Smartport  assigns  each  device  a  unique 
number  during  initialization  (on  startup  and  cold 
reset).  The  numbers  are  in  the  range  $01-$7E  and 
are  assigned  according  to  the  devices'  positions  in 
the  daisy  chain.  A  unit  number  of  $00  in  the 
STATUS  call  returns  the  number  of  devices 
connected  to  the  Smartport. 

Points  to  the  buffer  into  which  the  data  are  read. 
The  buffer  must  be  512  or  more  bytes  in  length. 

The  logical  address  of  a  block  of  data  to  be  read. 
There  is  no  general  connection  between  block 
numbers  and  the  layout  of  tracks  and  sectors  on 
the  disk.  The  translation  from  logical  to  physical 
blocks  is  performed  by  the  device.  (The  most 
significant  byte  is  0  for  all  devices  currently  in  use.) 


Possible  errors 

The  following  errors  can  be  returned  by  the  READ  BLOCK  call: 


$01 

BadCmd 

An  unimplemented  command  was  issued 

$04 

BadPCnt 

Bad  call  parameter  count 

$06 

BusErr 

Communications  error 

$27 

lOError 

I/O  error 

$28 

NoDrive 

No  device  connected 

$2D 

BadBlock 

Invalid  block  number 

$2F 

OffLine 

Device  off-line  or  no  disk  in  drive 

Descriptions  of  tl^e  Smartport  caiis 
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WRITE  BLOCK 


Command 
number 

Parameter 
list 


$02 

$03  (parameter  count) 

Unit  number 

Data  buffer  Oow  byte,  high  byte) 

Block  number  Oow  byte,  mid  byte,  high  byte) 

The  WRITE  BLOCK  call  writes  one  512-byte  block  from  memory  to 
the  disk  device  specified  by  the  unit-number  parameter.  The  block 
in  memory  starts  at  the  address  specified  by  the  data-buffer 
parameter. 


Parameter  descriptions 


Parameter 
count 
1-byte  value 

Unit  number 
1-byte  value 


Data  buffer 
2-byte  value 

Blocic  number 
3-byte  value 


Three  for  this  call. 

The  Smartport  assigns  each  device  a  unique 
number  during  initialization  (on  startup  and  cold 
reset).  The  numbers  are  in  the  range  $01-$7E  and 
are  assigned  according  to  the  devices'  positions  in 
the  daisy  chain.  A  unit  number  of  $00  in  the 
STATUS  call  returns  the  number  of  devices 
connected  to  the  Smartport. 

Points  to  the  buffer  from  which  the  data  are  to  be 
written. 

The  logical  address  of  a  block  of  data  to  be  written. 
There  is  no  general  connection  between  block 
numbers  and  the  layout  of  tracks  and  sectors  on 
the  disk.  The  translation  from  logical  to  physical 
blocks  is  performed  by  the  device.  (The  most 
significant  byte  is  0  for  all  devices  currently  in  use.) 
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Possible  errors 

The  following  errors 

can  be  returned  by  the  WRITE  BLOCK  call: 

$01 

BadCmd 

An  unimplemented  command  was  issued 

$04 

BadPCnt 

Bad  call  parameter  count 

$06 

BusErr 

Communications  error 

$27 

lOError 

I/O  error 

$28 

NoDrive 

No  device  connected 

$2B 

NoWrite 

Disk  write  protected 

$2D 

BadBlock 

Invalid  block  number 

$2F 

Offline 

Device  off-line  or  no  disk  in  drive 

FORMAT 

Command         $03 

number 

Parameter         $01  (parameter  count) 

list 

Unit  number 

The  FORMAT  call  prepares  all  blocks  on  the  recording  medium  of  a 
block  device  for  reading  and  writing.  The  formatting  done  by  this 
call  is  specific  to  each  device  and  is  not  linked  to  any  operating 
system;  for  example,  bitmaps  and  catalogs  are  not  written  by  this 
call. 


Parameter  descriptions 


Parameter 
count 

1-byte  value 

Unit  number 
1-byte  value 


One  for  this  call. 

The  Smartport  assigns  each  device  a  unique 
number  during  initialization  (on  startup  and  cold 
reset).  The  numbers  are  in  the  range  $01-$7E  and 
are  assigned  according  to  the  devices'  positions  in 
the  daisy  chain.  A  unit  number  of  $00  in  the 
STATUS  call  returns  the  number  of  devices 
connected  to  the  Smartport. 


Descriptions  of  the  Smartport  calls 
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Possible  errors 

The  following  errors  can  be  returned  by  the  FORMAT  call: 


$01        BadCmd 

An  unimplemented  command  was  issued 

$04        BadPCnt 

Bad  call  parameter  count 

$06        BusErr 

Communications  error 

$27        lOError 

I/O  error 

$28        NoDrive 

No  device  cormected 

$2B        No  Write 

Disk  write  protected 

$2F        Offline 

Device  off-line  or  no  disk  in  drive 

CONTROL 

Command       $04 

number 

Param«t«r       $03  (parameter  count) 

list                  Unit  n 

lumber 

Control  list  Oow  byte,  high  byte) 
Control  code 

The  CONTROL  call  sends  control  information  to  the  device.  The 
information  can  be  of  a  general  nature  (such  as  resets  or  interrupts), 
or  device-specific  (such  as  Download  to  UniDisk  35  RAM). 


Important     A  CONTROL  call  to  unit  number  $00  sends  control  Information  to 
the  Smartport  Itself.  See  thie  discussions  of  control  code  =  $00 
and  control  code  =  $01 ,  below. 


Parameter  descriptions 


Parameter 
count 
1-byte  value 

Unit  number 
1-byte  value 


Three  for  this  call. 

The  Smartport  assigns  each  device  a  unique 
number  during  initialization  (on  startup  and  cold 
reset).  The  numbers  are  in  the  range  $01-$7E  and 
are  assigned  according  to  the  devices'  positions  in 
the  daisy  chain.  A  unit  number  of  $00  in  the 
STATUS  call  returns  the  number  of  devices 
connected  to  the  Smartport  Use  a  unit 
number  of  $00  in  the  CONTROL  call  to  send 
control  information  to  the  Smartport  itself. 
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Control  list 

2-byte  value         Points  to  the  buffer  containing  the  control 

information.  The  first  two  bytes  (the  count  bytes, 
low  byte  first)  of  the  control  list  specify  the  number 
of  bytes  in  the  list  (.not  including  the  count  bytes); 
the  remainder  of  the  list  contains  the  control 
information  passed  to  the  device. 


Important     Every  CONTROL  call  must  hiave  a  control  list;  if  no  control 

information  is  being  passed,  thien  the  control  list  consists  of  the 
count  bytes  only: 

CTRL_LIST  DW  $00 

Control  code         The  number  of  the  control  request  being  made. 
1-byte  value         Control  codes  are  in  the  range  $00-$FF.  The 
following  requests  are  not  device  specific: 

Code       Control  function 

$00  Reset  the  device 

$01  Set  device  control  block  (DCB) 

$02  Set  newline  status  (character  devices  only) 

$03  Service  device  interrupt 

Control  requests  to  unit  number  $00  are  sent  to  the 
Smartport  itself: 

Code       Control  function 

$00         Enable  interrupts  from  Smartport 
$01         Disable  interrupts  from  Smartport 

Specific  devices  may  respond  to  some  or  all  of 
these  additional  control  requests: 

Code       Control  function 

$04  Eject  disk 

$05  Run  a  65C02  subroutine 

$06  Set  download  address 

$07  Download  to  device  RAM 
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Control  code  =  $00  performs  a  warm  reset  of  the  device  and 
generally  returns  "housekeeping"  values  to  some  reset  value.  The 
control  list  for  this  call  is  device  dependent. 

The  control  list  for  this  call  for  UniDisk  3.5  devices  is 

CTRL_LIST  DW     $00         No  parameters  are  passed. 

A  CONTROL  call  with  control  code  =  $00  and  unit  number  =  $00 
enables  interrupts  from  the  Smartport.  This  informs  the  firmware 
that  external  interrupts  are  possible,  and  directs  it  to  call  the  user's 
interrupt  handler  if  an  interrupt  occurs.  It  also  turns  on  the  ACIA  for 
port  1. 

When  the  user's  interrupt  handler  identifies  an  external  interrupt, 
you  can  determine  if  it  came  from  the  Smartport  by  making  a 
STATUS  call  with  unit  number  =  $00  and  control  code  =  $00.  See 
Appendix  E  for  more  information  on  handling  interrupts. 

Control  code  =  $01  alters  the  contents  of  the  device  control 
block  (DCB).  The  DCB  is  used  to  set  global  aspects  of  a  device's 
operating  envirormient.  Each  device  has  a  default  setting  for  the 
DCB,  set  on  initialization.  Because  the  length  of  the  DCB  is  device 
dependent,  you  should  first  read  in  the  DCB  with  the  STATUS  call, 
then  alter  the  bits  of  interest,  and  finally,  use  the  same  byte  string  as 
the  control  block  for  the  CONTROL  call.  The  first  byte  (the  count 
byte)  of  the  DCB  gives  the  number  of  bytes  in  the  control  block  (not 
including  the  count  byte),  so  the  length  never  exceeds  257  bytes, 
including  the  count  byte. 

Note  that  because  UniDisk  3.5  has  no  DCB,  a  Set  DCB  CONTROL 
call  to  UniDisk  3.5  returns  an  error  (BadCtl  $21). 

A  CONTROL  call  with  control  code  =  $01  and  unit  number  =  $00 
disables  interrupts  from  the  Smartport.  This  call  turns  off  the  ACLA. 
for  port  1  and  sets  the  least  significant  bit  of  the  ACIA  control 
register  to  0. 

Control  code  =  $02  sets  a  character  device  to  newline  enabled  or 
newline  disabled. 
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Control  code  =  $03  sends  a  device  service  intermpt.  This  code  is  to 
be  vised  as  needed  for  intermpt-driven  devices. 

Control  code  =  $04  ejects  a  disk.  This  code  is  to  be  used  for  devices 
that  support  an  auto-eject  feature.  This  code  causes  UniDisk  3.5  to 
auto-eject  a  disk.  There  are  no  parameters  in  the  control  list,  and 
no  errors  are  returned  if  the  disk  ejected  correctly  or  there  was  no 
disk  in  the  drive.  Error  code  $27  OOError)  is  returned  if  the  eject 
failed — that  is,  if  a  disk  is  still  in  the  drive.  The  control  list  for 
UniDisk  3.5  is 


CTRL   LIST   DW 


$00 


No  parameters  are  passed. 


Warning      Control  codes  $05  and  higher  are  reserved;  use  of  some  of 
these  codes  can  cause  your  system  to  crash. 


Possible  errors 

The  following  errors  can  be  returned  by  the  CONTROL  call: 


$01 


BadCmd 


An  unimplemented  command  was 


issued 

$04 

BadPCnt 

Bad  call  parameter  count 

$06 

BusErr 

Communications  error 

$21 

BadCtl 

Invalid  control  code 

$22 

BadCtlParm 

Invalid  parameter  list 

$30-$3F 

Device-specific  errors 

INIT 

Command       $05 
number 

Parameter       $01  (parameter  count) 
list  $00  (unit  number) 

The  INIT  call  resets  all  intelligent  devices  attached  to  the  Smartport. 
The  Smartport  goes  through  an  initialization  sequence,  cold- 
resetting  all  devices  and  sending  each  its  unit  number.  This  call  is 
made  automatically  on  startup;  an  application  should  never  have  to 
make  this  call. 
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Parameter  descriptions 


Parameter 
count 

1-byte  value 


One  for  this  call. 


Unit  number 

1-byte  value        The  unit  number  used  in  this  call  is  always  $00. 


Possible  errors 

The  following  errors  can  be  returned  by  the  INIT  call: 

$01        BadCmd        An  unimplemented  command  was  issued 


$04        BadPCnt 
$06        BusErr 
$28        NoDrive 


Bad  call  parameter  count 
Communications  error 
No  device  connected 


OPEN 

Command         $06 
number 

Parameter        $01  (parameter  count) 
list  Unit  number 

The  OPEN  call  prepares  a  character  device  for  reading  or  writing. 

Note  that  since  UniDisk  3.5  is  a  block  device,  it  does  not  accept  this 
call.  An  attempt  to  use  an  OPEN  call  with  UniDisk  3.5  will  result  in 
an  error  (BadCmd  $01). 


Parameter  descriptions 


Parameter 
count 

1-byte  value 

Unit  number 
1-byte  value 


One  for  this  call. 

The  Smartport  assigns  each  device  a  unique 
number  during  initialization  (on  startup  and  cold 
reset).  The  numbers  are  in  the  range  $01-$7E  and 
are  assigned  according  to  the  devices'  positions  in 
the  daisy  chain.  A  unit  number  of  $00  in  the 
STATUS  call  returns  the  number  of  devices 
connected  to  the  Smartport. 
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Possible  errors 

The  following  errors  can  be  returned  by  the  OPEN  call: 

An  unimplemented  command  was  issued 

Bad  call  parameter  count 

Communications  error 

No  device  connected 

Device  off-line  or  no  disk  in  drive 


$01 

BadCmd 

$04 

BadPCnt 

$06 

BusErr 

$28 

NoDrive 

$2F 

Offline 

CLOSE 

Command         $07 
number 

Parameter        $01  (parameter  count) 
list  Unit  number 

The  CLOSE  call  tells  a  character  device  that  a  sequence  of  reads  or 
writes  is  over. 

Note  that  since  UniDisk  3.5  is  a  block  device,  it  does  not  accept  this 
call.  An  attempt  to  use  a  CLOSE  call  with  UniDisk  3.5  will  result  in  an 
error  (BadCmd  $01). 


Parameter  descriptions 


Parameter 
count 
1-byte  value 

Unit  number 
1-byte  value 


One  for  this  call. 

The  Smartport  assigns  each  device  a  unique 
number  during  initialization  (on  startup  and  cold 
reset).  The  numbers  are  in  the  range  $01-$7E  and 
are  assigned  according  to  the  devices'  positions  in 
the  daisy  chain.  A  unit  number  of  $00  in  the 
STATUS  call  returns  the  number  of  devices 
connected  to  the  Smartport. 
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Possible  errors 

The  following  errors  can  be  returned  by  the  CLOSE  call: 

$01        BadCmd  An  unimplemented  command  was  issued 

$04        BadPCnt  Bad  call  parameter  count 

$06        BusErr  Communications  error 

$28        NoDrive  No  device  connected 

$2F        Offline  Device  off-line  or  no  disk  in  drive 


READ 

Command        $08 
number 

Parameter        $04  (parameter  count) 

list  Unit  number 

Buffer  pointer  Oow  byte,  high  byte) 

Byte  count  Oow  byte,  high  byte) 

Address  pointer  Oow  byte,  mid  byte,  high  byte) 

The  READ  call  reads  into  memory  the  number  of  bytes  specified  by 
the  byte-count  parameter.  The  bytes  are  placed  in  a  buffer  starting 
at  the  address  specified  by  the  buffer-pointer  parameter. 


Parameter  descriptions 


Parameter 
count 
1-byte  value 

Unit  number 
1-byte  value 


Buffer  pointer 
2-byte  point 


Four  for  this  call. 

The  Smartport  assigns  each  device  a  unique 
number  during  initialization  (on  startup  and  cold 
reset).  The  numbers  are  in  the  range  $01-$7E  and 
are  assigned  according  to  the  devices'  positions  in 
the  daisy  chain.  A  unit  number  of  $00  in  the 
STATUS  call  returns  the  number  of  devices 
connected  to  the  Smartport. 

Points  to  the  buffer  into  which  the  data  is  read. 
The  buffer  must  be  large  enough  to  contain  the 
number  of  bytes  requested  by  the  byte-count 
parameter. 
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Byte  count 
2-byte  value 

Address 
pointer 
3-byte  value 


Specifies  the  number  of  bytes  to  be  transferred. 


Specifies  the  address  to  start  reading  from.  The 
meaniiig  of  this  parameter  depends  on  the  device 
being  read. 


Possible  errors 

The  following  errors  can  be  returned  by  the  READ  call: 

An  unimplemented  command  was  issued 

Bad  call  parameter  count 

Communications  error 

I/O  error 

No  device  connected 

Invalid  block  number 

Device  off-line  or  no  disk  in  drive 


$01 

BadCmd 

$04 

BadPCnt 

$06 

BusErr 

$27 

lOError 

$28 

NoDrive 

$2D 

BadBlock 

$2F 

OffLine 

WRITE 


Command 

$09 

number 

Parameter 

$04  (parameter  count) 

list 

Unit  number 

Buffer  pointer  Oow  byte,  high  byte) 

Byte  count  Oow  byte,  high  byte) 

Address  pointer  Oow  byte,  mid  byte,  high 

byte) 

The  WRITE  call  writes  from  memory  the  number  of  bytes  specified 
by  the  byte-count  parameter  to  the  specified  unit.  The  bytes  in 
memory  start  at  the  address  indicated  by  the  buffer-pointer 
parameter.  The  meaning  of  the  address  pointer  depends  on  the 
type  of  device  (see  parameter  descriptions). 


Descriptions  of  the  Smartport  calis 
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Parameter  descriptions 


Parameter 
count 
1-byte  value 

Unit  number 
1-byte  value 


Buffer  pointer 
2-byte  value 

Byte  count 

2-byte  value 

Address 
pointer 
3-byte  value 


Four  for  this  call. 

The  Smartport  assigns  each  device  a  unique 
number  during  initialization  (on  startup  and  cold 
reset).  The  numbers  are  in  the  range  $01-$7E  and 
are  assigned  according  to  the  devices'  positions  in 
the  daisy  chain.  A  unit  number  of  $00  in  the 
STATUS  call  returns  the  number  of  devices 
connected  to  the  Protocol  Converter. 

Points  to  the  buffer  from  which  the  data  is  to  be 
written. 

Specifies  the  number  of  bytes  to  be  transferred. 


Specifies  the  address  to  start  writing  from.  The 
meaning  of  this  parameter  depends  on 
the  device  being  written  to. 


Possible  errors 

The  following  errors  can  be  returned  by  the  WRITE  call: 

$01        BadCmd  An  unimplemented  command  was  issued 

$04        BadPCnt  Bad  call  parameter  count 

$06        BusErr  Communications  error 

$27        lOError  I/O  error 

$28        NoDrive  No  device  connected 

$2D       BadBlock  Invalid  block  number 

$2F        Offline  Device  off-line  or  no  disk  in  drive 
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An  example:  issuing  a  Smartport  call 

Here  is  an  example  of  a  program  that  issues  a  STATUS  call  to  the 
Smartport  to  obtain  information  about  a  device. 

The  code  for  the  Smartport  in  the  version  of  the  Apple  lie  that 
supports  UniDisk  3.5  always  begins  at  address  $C500;  however,  to 
ensure  compatibility  with  the  Apple  He,  your  programs  should 
always  do  a  search  for  the  Smartport,  as  in  this  example. 


1 

* 

2 

* 

3 

* 

4 

* 

This  example 

shows  how  to  find 

5 

* 

and  use  a  PC 

interface.  A  search 

6 

* 

is  made  for 

a  PC,  and  when  one  is 

7 

* 

found,  a  vector  is  set  up  which 

8 

* 

points  to  the  PC  entry.  Then  a 

9 

* 

Device  Information  Block  STATUS  call 

10 

jt 

is  made,  and 

if  successful,  the  name 

11 

* 

string  embedded  in  the  DIB  is  output 

12 

* 

to  the  screen.  Only  the  first  device 

13 

* 

in  the  chain 

is  accessed. 

14 

* 

15 

* 

16 

MSB 

ON 

17 

* 

18 

* 

0006 

19 

ZPTempL    equ 

$000  6    /Temporary  zero 

20 

* 

page  storage 

0007 

21 

ZPTempH    equ 

$0007 

22 

* 

FDED 

23 

COut      equ 

$FDED     /Console  output 

FD8E 

24 

CROut      equ 

$FD8E    /Carriage  return 

25 

* 

0000 

26 

StatusCmd  equ 

0 

27 

* 

28 

* 

0300 

29 

30 

* 

org 

$300 

31 

* 

Find  a  Smartport  in  one  of  the 

32 

* 

slots . 

33 

* 

20  43  03 

34 

jsr 

FindPC 

BO  IC    0321 

35 
36 

* 

bcs 

Error 

37 

* 

Now  make  the  DIB  call  to  the  first  guy 

38 

* 

An  example;  Issuing  a  Smartport  coll 
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0305 

20 

67 

03 

39 

jsr 

Dispatch 

0308:00 

40 

dfb 

StatusCmd 

0309 :6A 

03 

41 

dw 

DParms 

030B:BO 

14 

0321 

42 

bcs 

Error 

030D: 

43 

* 

030D: 

44 

*  Got  the 

DIB; 

now  print  the  name  string 

030D: 

45 

* 

030D:A2 

00 

46 

Idx 

#0 

030F: 

030F 

47 

morechars 

equ 

* 

030F:BD 

74 

03 

48 

Ida 

DIBName,x 

0312:09 

80 

49 

ora 

#$80     ;COut  wants  high 

0314 

50 

* 

Bit  set 

0314 

51 

*  0314:20 

ED  FD       52           jsr    COut 

0317 

E8 

53 

inx 

0318 

EC 

73 

03 

54 

cpx 

DIBNameLen 

0318 

90 

F2 

030F 

55 

bit 

morechars 

031D 

56 

* 

031D 

20 

8E 

FD 

57 

jsr 

CROut    /Finish  it  off 

0320 

58 

* 

with  a  return 

0320 

59 

* 

0320 

60 

60 

rts 

0321 

61 

•k 

0321 

62 

* 

0321 

0321 

63 

Error 

equ 

* 

0321 

64 

* 

0321 

65 

*  There's 

either  no  PC  around,  or  there 

0321 

66 

*  was  no 

Unit 

#1...  give  message 

0321 

67 

* 

0321 

A2 

00 

68 

Idx 

#0 

0323 

0323 

69 

errl 

equ 

* 

0323 

BD 

2F 

03 

70 

Ida 

Message, X 

0326 

FO 

06 

032E 

71 

beq 

errout 

0328 

20 

ED 

FD 

72 

jsr 

COut 

032B 

E8 

73 

inx 

032C 

DO 

F5 

0323 

74 

bne 

errl 

032E 

75 

* 

032E 

032E 

76 

errout 

equ 

* 

032E 

60 

77 

rts 

032F 

78 

* 

032F 

CE 

CF 

AO  DO 

79 

Message 

asc 

'NO  PC  OR  NO  DEVICE' 

0341 

8D 

00 

80 

dfb 

$8D,0 

0343 

81 

* 

0343 

82 

* 

0343 

0343 

83 

FindPC 

equ 

* 

0343 

84 

• 

0343 

85 

*  Search 

slot 

7  to  slot  1  looking  for 

0343 

86 

*   sign at 

ure  bytes 

0343 

87 

* 

0343 

A2 

07 

88 

Idx 

#7       ;Do  for  seven 

0345 

89 

* 

slots 
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A9 

C7 

90 

Ida 

#$C7 

85 

07 

91 

sta 

ZPTempH 

A9 

00 

92 

Ida 

#$00 

85 

06 

93 

94 

* 

sta 

ZPTempL 

034D 

95 

newslot 

equ 

* 

AO 

07 

96 

97 

* 

Idy 

#7 

034F 

98 

again 

equ 

* 

Bl 

06 

99 

Ida 

(ZPTempL) ,y 

D9 

70 

03 

100 
101 

* 

cmp 

sigtab,y     ;One  of  four 
byte  signature 

FO 

07 

035D 

t 

102 
103 

* 

beq 

maybe        /Found  one 

signature  byte 

C6 

07 

104 

dec 

ZPTempH 

CA 

105 

dex 

DO 

F2 

034D 

106 
107 

* 

bne 

newslot 

108 

* 

If  we 

get  here,  it's  because  we  couldn' 

109 

* 

find 

a  Smartport . 

110 

* 

Exit  with  the 

carry  set . 

111 

* 

38 

112 

sec 

60 

113 
114 

* 

rts 

115 

* 

If  we 

get  here,  it  means  that  one  or 

116 

* 

more 

of  the 

signature  bytes 

117 

* 

for  this  card  are  what  we're  looking 

118 

* 

for. 

Decrement  the  byte 

119 

* 

counter  and 

branch  back  to  verify  any 

120 

* 

remaining  bytes. 

121 

* 

035D 

122 

maybe 

equ 

* 

88 

123 

dey 

88 

124 
125 

* 

dey 

;lf  N=l  then 
all  sig  bytes  okay 

10 

EE 

034F 

126 
127 

* 

bpl 

again 

128 

* 

Found 

a  Smartport  interface. 

129 

* 

Set  up  the  call  address. 

130 

* 

We  already  have  the  high  byte  ($CN) ; 

131 

* 

we  just  need 

the  low  byte. 

132 

* 

0361 

133 

foundPC 

equ 

* 

A9 

FF 

134 

Ida 

#$FF 

85 

06 

135 

sta 

ZPTempL 

AO 

00 

136 
137 

* 

Idy 

#0            ; For 

indirect  load 

Bl 

06 

138 
139 

* 

Ida 

(ZPTempL) ,y   ;Get  the 
byte 

An  example:  issuing  a  Smartport  cail 
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0369 

140 

* 

0369 

141 

* 

Now  the  Ace  h 

as  the  low  order  ProDOS 

0369 

142 

* 

entry 

point . 

The  PC  entry  is 

0369 

143 

* 

three 

locations  past  this... 

0369 

144 

* 

0369 

18 

145 

clc 

03  6A 

69 

03 

146 

adc 

#3 

03  6C 

85 

06 

147 

St  a 

ZPTempL 

036E 

148 

* 

036E 

149 

* 

Now  ZPTempL  has  the  PC  entry  point. 

036E 

150 

* 

Return  with 

carry  clear. 

036E 

151 

* 

03  6E 

18 

152 

clc 

036F 

60 

153 

rts 

0370 

154 

* 

0370 

155 

* 

0370 

156 

* 

These  are  the 

PC  signature  bytes  in 

0370 

157 

* 

their 

relative  order. 

0370 

158 

* 

The  $FF  bytes  are  filler  bytes  and 

0370 

159 

* 

are  not  compared. 

0370 

160 

* 

0370 

:FF 

20 

FF 

00 

161 

sigtab 

dfb 

$FF,$20,$FF,$00 

0374 

FF 

03 

FF 

00 

162 

dfb 

$FF,$03,$FF,$00 

0378 

163 

* 

0378 

164 

* 

0378 

0378 

165 

Dispatch 

equ 

* 

0378 

6C 

06 

00 

166 

jmp 

(ZPTempL)     /Simulate 

037B 

167 

* 

an  indirect  JSR  to  P 

037B 

168 

* 

037B 

169 

* 

037B 

037B 

170 

DE 

arms 

equ 

* 

037B 

03 

171 

DPParmCt 

dfb 

3            /Status 

037C 

172 

* 

calls  have  three  parameter 

037C 

01 

173 

DPUnit 

dfb 

1 

037D 

80 

03 

174 

DPBuffer 

dw 

DIB 

037F 

03 

175 

DPStatCode  dfb 

3 

0380 

176 

* 

0380 

177 

* 

0380 

0380 

178 

DIB 

equ 

* 

0380 

00 

179 

DIBStatBytel  dfb  0 

0381 

00 

00 

00 

180 

DIBDevSize  dfb 

0,0,0 

0384 

00 

181 

DIBNameLen  dfb 

0 

0385 

0010 

182 

DIBName 

ds 

16,0 

0395 

00 

183 

DIBType 

dfb 

0 

0396 

00 

184 

DIBSubType  dfb 

0 

0397 

00 

00 

185 

DIBVersion  dw 

0 

0399 

186 

* 

0399 

187 

* 
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Summary  of  commands  and  parameters 

The  following  is  a  summary  of  Smartport  calls.  In  each  case,  byte  0 
of  the  command  parameter  list  (CmdLst)  specifies  the  number  of 
parameters  in  the  command  list  (not  including  byte  0).  Parameters 
that  require  more  than  one  byte  (the  status  list  pointer,  for 
example)  are  entered  low  byte  first  The  meaning  of  the  address- 
pointer  parameter  is  device  specific.  See  the  sections  on  the 
individual  calls  in  this  chapter  for  a  discussion  of  each  parameter. 


Command 

STATUS 

READBLOCK 

WRITEBLOCK 

FORMAT 

CONTROL 

CmdNum 

$00 

$01 

$02 

$03 

$04 

CmdListByte 

■0 

$03 

$03 

$03 

$01 

$08 

1 

Unit  Num 

Unit  Num 

Unit  Num 

Unit  Num 

Unit  Num 

2 

Stat  List  Ptr 

Buffer  Ptr 

Buffer  Ptr 

Ctl  List  Ptr 

3 

4 

Stat  Code 

Block  Num 

Block  Num 

Ctl  Code 

5 

6 

Command 

INIT 

OPEN 

CLOSE 

READ 

WRITE 

CmdNum 

$05 

$06 

$07 

$08 

$09 

CmdList  Byte 

0 

$01 

$01 

$01 

$04 

$04 

1 

$00 

Unit  Num 

Unit  Num 

Unit  Num 

Unit  Num 

2 

Buffer  Ptr 

Buffer  Ptr 

3 

4 

Byte  Count 

Byte  Count 

5 

6 

7 

Address  Ptr 

Address  Ptr 

8 

Unused  bytes  C 

Figure  6-1 

Summary  of  Smartport  calls 


Summary  of  commands  and  parameters 
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Summary  of  error  codes 

The  following  is  a  summary  of  Smartport  call  error  codes,  including 
a  brief  description  of  the  possible  causes  for  each.  If  there  is  no 
error,  the  C  flag  (in  the  processor  status  register  of  the  65C02 
microprocessor)  is  cleared  (0)  and  the  accumulator  (the  A  register) 
contains  Os;  If  the  call  was  unsuccessful,  the  C  flag  is  set  (1)  and  the 
A  register  contains  the  error  code. 

$00  No  error. 

$01  BadCmd  A  nonexistent  command  was  issued. 

Check  the  command  number  in  the 
Smartport  call. 

$04  BadPCnt  Bad  call  parameter  count.  The  call 

parameter  list  was  not  properly 
constructed.  Make  sure  the  parameter 
list  has  the  correct  number  of 
parameters. 

$06  BusErr  A  communications  error  between  the 

device  controller  and  the  host.  Make 
sure  that  RAM  is  both  read-enabled 
and  write-enabled.  Check  the 
hardware  (cables  and  connectors) 
between  the  device  and  the  host. 
Check  for  noise  sources.  Make  sure  the 
cable  is  properly  shielded. 

$11  BadUnit  Unit  number  $00  was  used  in  a  call 

other  than  STATUS,  CONTROL,  or 
INIT. 

$21  BadCtl  The  control  or  status  code  is  not 

supported  by  the  device. 

$22  BadCtlParm        The  control  parameter  list  contains 

'  invalid  information.  Make  sure  each 

value  is  within  the  range  allowed  for 
that  parameter. 
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$27  lOError  The  device  encountered  an  I/O  error 

when  trying  to  read  or  write  to  the 
recording  medium.  Make  sure  that  the 
medium  in  the  device  is  formatted 
and  not  defective  and  that  the  device 
is  operating  correctly. 

$28  NoDrive  The  device  is  not  connected.  This  can 

occur  if  the  device  is  not  connected 
but  its  controller  is,  or  if  there  is  no 
device  with  the  unit  number  specified. 

$2B  No  Write  The  medium  in  the  device  is  write 

protected. 

$2D  BadBlock  The  block  number  is  outside  the  range 

allowed  for  the  medium  in  the  device. 
Note  that  this  range  depends  on  the 
type  of  device  and  the  type  of  medium 
in  the  device  (single-sided  versus 
double-sided  disk,  for  example). 

$2F  Offline  Device  off-line  or  no  disk  in  drive. 

Check  the  cables  and  connections. 
Make  sure  that  the  medium  is  present 
in  the  drive  and  that  the  drive  is 
functioning  correctly. 

$30-$3F       DevSpec  Errors  that  differ  from  device  to 

device.  See  the  technical  manual  for 
the  device  in  question  for  details. 
$40-$4F.  Reserved  for  future 
expansion. 

$50-$7F       NonFatal  A  device-specific  soft  error.  The 

operation  completed  successfully,  but 
some  exception  conditiori  was 
detected.  See  the  technical  manual  for 
the  device  in  question  for  details. 
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Serial  I/O 
Port  1 
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Serial  port  1  is  one  of  two  serial  I/O  ports  available  on  the 
Apple  lie.  It  is  intended  primarily  as  an  output  port  for  RS-232 
devices,  such  as  printers  and  plotters.  It  can  be  changed  to  a  serial 
communication  port  Oike  port  2)  by  using  the  System  Utilities  disk 
or  from  a  program. 


Warning     Although  the  Apple  lie  serial  ports  are  similar  to  the  Apple  He 
Super  Serial  Card,  there  are  Important  differences.  Refer  to 
Appendix  F  for  a  summary  of  these  differences. 

Table  7-1  summarizes  the  characteristics  of  this  port  if  used  as  a 
printer/plotter  port,  and  is  a  guide  to  the  other  information  in  this 
chapter.  If  you  change  port  1  to  a  communication  port,  refer  to  the 
descriptions  in  Chapter  8,  and  use  1  instead  of  2  for  the  port 
number  when  required. 

The  serial  port  back  panel  connectors  are  described  in  Chapter  11. 

Table  7-1 

Serial  port  1  characteristics 


Port  number 
Commands 


Initial  characteristics 

Hardware  page 
locations 

Monitor  firmware 
routines 

I/O  firmware 
entry  points 

Use  of  screen  holes 

Use  of  other  pages 


Serial  port  1. 

Keyboard  command:  PR#1. 
BASIC  command:  PR#1. 
Monitor  command:  1  Control-P 
(does  not  work  if  there  is  an  operating 
system  in  RAM). 
All  other  commands:  See  Table  7-2. 

See  "Characteristics  of  Port  1  at 
Startup." 

See  Table  7-3. 

None. 

See  Table  7-4. 

See  Table  7-5. 
None. 
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Refer  to  Table  7-4  for  the 
standard  firmware  entry  points 
that  Pascai  1 . 1  and  1 .2  use. 


Using  serial  port  1 

You  can  access  the  firmware  from  BASIC  in  the  usual  way — that  is, 
by  issuing  Control-D  (if  DOS  or  ProDOS  is  in  RAM)  and  PR#1. 
Subsequent  output  is  directed  to  the  printer  (or  other  device) 
connected  to  serial  port  1. 

To  direct  Pascal  output  to  the  printer,  you  can  use  either  #6:  or 
PRINTER:. 

Your  programs  can  also  access  the  port  by  changing  the  value  of 
CSW  (see  Chapter  3). 

Table  7-2  lists  the  commands  you  can  use  with  serial  port  1,  either 
from  a  program  or  from  the  keyboard,  after  you  issue  PR#1. 


UniDisk  3.5     Commands  followed  by  an  asterisk  in  Table  7-2  (witli  the 
exception  of  L)  are  available  only  on  ttie  version  of  the 
Apple  lie  that  supports  UnlDisk  3.5.  These  commands  can  be 
toggled  by  following  them  directly  with  E  (enable)  or  D 
(disable). 

Each  command  must  be  preceded  by  Control-I  (the  command 
character).  As  soon  as  you  issue  the  command  character,  the  serial 
port  firmware  displays  a  flashing  question  mark  cursor  to  indicate  it 
is  awaiting  a  command.  You  do  not  have  to  press  Return  after 
commands  that  you  have  entered  from  the  keyboard,  or  send  the 
return  character  from  your  program  if  it  is  sending  commands  to 
the  port.  You  can  type  more  than  one  command  on  a  line,  but  each 
must  be  preceded  by  the  command  character. 

Table  7-2 

Printer  port  commands 

Command        Description 


nnn 


nnB 


Sets  new  line  width  of  nnn  (from  1  through  255).This 
command  must  be  followed  by  N  (see  below)  or  by  a 
carriage  return. 


Sets  baud  rate  to  value  corresponding  to  nn: 


nn 


Rote 


nn 


Rate 


nn 


Rate 


1 

50 

6 

300 

11 

3600 

2 

75 

7 

600 

12 

4800 

3 

no  (109.92) 

8 

1200 

13 

7200 

4 

135  (134.58) 

9 

1800 

14 

9600 

5 

150 

10 

2400 

15 

1920 

Using  serial  port  1 
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Table  7-2  (continued) 
Printer  port  commands 


Command        Description 


C  *  When  enabled,  this  command  causes  a  carriage 

return  character  to  be  sent  automatically  whenever 
the  column  count  exceeds  the  printer  line  width.  The 
command  is  normally  enabled. 

nD  Sets  data  format  to  values  corresponding  to  n: 


n 

Data 
bits 

Stop 
bits 

n 

Data 
bits 

Stop 
bits 

0 

8 

1 

4 

8 

2 

1 

7 

1 

5 

7 

2 

2 

6 

1 

6 

6 

2 

3 

5 

1 

7 

5 

2 

F*  When  this  command  is  enabled,  your  Apple  lie 

accepts  data  from  the  keyboard  as  well  as  from  the 
serial  port.  You  can  use  this  to  disable  the  keyboard 
before  receiving  or  sending  data  to  prevent  accidental 
keystrokes  from  disrupting  the  data  flow.  Be  sure  that 
your  program  reenables  the  keyboard  when  the  data 
transfer  is  complete.  This  command  is  available  only 
from  BASIC  and  is  normally  enabled. 

I  Echoes  printer  output  on  the  screen. 

K  Disables  automatic  line  feed  after  carriage  return. 

L*  Generates  line  feed  after  carriage  return.  Normally, 

this  command  is  enabled.  Disabling  it  has  the  same 
effect  as  the  K  command. 

M  *  When  this  command  is  enabled,  all  incoming  line 

feed  characters  are  masked  (removed  from  the  data 
stream).  Normally  this  command  is  enabled. 
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Table  7-2  (continued) 
Printer  port  commands 


Command        Description 


nnnN 


nP 


Changes  line  width  to  nnn  (from  1  through  255; 
nnn  is  optional);  does  not  echo  printer  output  on  the 
screen.  Note:  ON  does  not  disable  automatic 
generation  of  carriage  return;  to  do  so,  use 
Z  command,  put  0  directly  in  location  $0579,  or  use 
the  System  Utilities  disk. 

Sets  parity  corresponding  to  n: 


n 

Parity 

n 

Parity 

0 

None 

4 

None 

1 

Odd 

5 

MARK(l) 

2 

None 

6 

None 

3 

Even 

7 

SPACE  (0) 

R  Resets  port  1  and  exits  from  serial  port  1 

firmware. 

S  Sends  a  233-millisecond  BREAK  character  (used  with 

some  printers  to  synchronize  with  serial  ports). 

X*  When  enabled,  this  command  turns  on  the 

XON/XOFF  protocol:  the  Apple  He  looks  for  the 
XOFF  ($13)  character  and  responds  by  halting 
transmission  until  an  XON  ($11)  is  received. 
Normally  this  command  is  disabled. 

Z  Zaps  (ignores)  further  command  characters  until 

Control-Reset  or  PR#1.  Does  not  format  output  or 
insert  carriage  returns  into  output  stream. 

Note:  The  commands  themselves  are  letter  commands,  not  control 

characters. 

•  Command  (with  the  exception  of  L)  is  available  only  on  the  version  of 
the  Apple  lie  that  supports  UniDisk  3.5.  Command  can  be  toggled:  If 
you  follow  the  command  with  E  (with  no  intervening  space),  the 
command  is  enabled.  If  you  follow  the  command  with  D  (with  no 
intervening  space),  command  is  disabled.  The  L  command  is  available 
on  the  earlier  Apple  lie,  but  cannot  be  toggled  there. 
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The  serial  port  1  command  character  is  set  as  Control-I  when  the 
Apple  lie  is  turned  on.  You  can  change  it  to  a  different  control 
character  by  sending  the  current  control  character  followed 
immediately  by  the  new  control  character  you  want.  This  is  useful  if 
you  want  to  be  able  to  send  Control-I  to  the  printer  without  firmware 
intervention.  For  example,  to  change  the  command  character  from 
Control-I  to  Control-V,  send  Control-I  Control-V  either  from  the 
keyboard  or  from  a  program.  (Control-V  and  Control-W  are  the 
recommended  substitute  control  characters.)  To  change  the 
command  character  back  again,  send  Control-V  Control-I.  Don't 
slip  any  spaces  between  the  control  characters  that  you  send. 

Warning      Do  not  use  Control-A,  -B,  -C,  -H,  -J,  -L,  -M,  or  -Y:  Apple  lie 
firmware  may  intercept  ttiese  control  characters,  causing 
unpredictable  results. 

The  following  are  examples  of  valid  commands  and  command 
sequences.  These  examples  all  show  commands  being  entered  from 
the  keyboard,  but  your  programs  can  send  the  characters  just  as 
well.  Remember  to  issue  a  PR#1  before  starting  to  send  commands 
to  serial  port  1. 

To  echo  output  to  the  display  screen: 

Control-I  I 

To  set  line  width  72,  disable  line  feed,  and  echo: 

Control-I  K  Control-I  7  2  N 

To  change  control  character  to  Control-V: 

Control-I  Control-V  Return 

To  set  up  the  serial  port  to  allow  sending  Control-I  as  part  of  a 
character  stream: 

Control-V  (command)  Return 
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Characteristics  of  port  1  at  startup 

After  power-up,  the  printer  firmware  sets  the  following 
configuration: 

D  9600  baud 

D  eight  data  bits,  no  parity  bits,  two  stop  bits 

n  SO-column  line  width;  no  echo  to  display  screen 

D  firmware  supplies  line  feed  after  carriage  return 

n  command  character  is  set  to  Control-I  (see  below) 

These  values  are  stored  in  the  auxiliary  memory  screen  holes 
(Table  7-5).  You  can  change  some  of  these  settings  from  the 
keyboard  by  typing  PR#1,  the  command  character,  and  one  of  the 
commands  listed  in  Table  7-2.  How  port  characteristics  change  as  a 
result  of  various  activities  is  desaibed  under  "Changing  Port  1 
Characteristics"  later  in  this  chapter. 


ACIA  stands  for  asynchronous 
communication  Interface 
adapter,  a  serial  I/O  chip.  Note  in 
Chapter  1 1  that  some  of  the  bit 
assignments  for  this  port  differ 
from  those  for  port  2. 


Hardware  page  locations  for  port  1 

Table  7-3  lists  for  serial  port  1  the  addresses  and  bit  assignments  of 
its  hardware  registers  on  page  $C0.  The  registers  are  internal  to  a 
6551  ACIA;  their  bit  assignments  are  described  in  Chapter  11. 


Warning 


This  table  is  for  your  information  only.  To  avoid  having  problems 
with  the  system,  you  should  never  try  to  directly  access  the 
hardware.  Instead,  use  the  Apple  lie's  built-in  firmware  in  your 
programs. 


Table  7-3 

Port  1  hardware  page  locations 


Location 

Description 

$C090-$C097 

Reserved 

$C098 

ACIA  transmit/receive  data  register 

$C099 

ACIA  status  register 

$C09A 

ACIA  command  register 

$C09B 

ACIA  control  register 

$C09C-$C09F 

Reserved 

Hardware  page  locations  for  port  1 
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I/O  firmware  support  for  port  1 

Table  7-4  lists  the  locations  and  values  of  the  I/O  firmware  protocol 
table.  This  standardized  protocol  is  available  for  use  by  any 
application  program.  Chapter  3  describes  how  to  use  this  protocol. 

Table  7-4 

Port  1  I/O  firmware  protocol 

Address    Value    Description 

$C105  $38  Pascal  ID  byte. 

$C107  $18  Pascal  ID  byte. 

$C10B  $01  Generic  signature  byte  of  firmware  cards. 

$C10C  $31  Same  ID  as  for  Super  Serial  Card. 

$C10D  $ii  $Clii  is  entry  point  of  initialization  routine  (PInit). 

$C10E  $rr  $Clrr  is  entry  point  of  read  routine  (PRead). 

$C10F  $ww  $Clww  is  entry  point  of  write  routine  (PWrite). 

$C110  $ss  $Clss  is  entry  point  of  the  status  routine  (PStatus). 

$C111  non-  No  optional  routines, 
zero 


The  ACIA  register  bits  are 
defined  in  Chapter  1 1 . 


Screen  hole  locations  for  port  1 

Table  7-5  lists  the  screen  hole  locations  that  serial  port  1  uses.  Note 
that  the  auxiliary  memory  locations  are  reserved  for  startup  value 
settings,  which  are  listed  and  interpreted  in  the  table. 

Table  7-5 

Port  1  screen  hole  locations 

Auxiliary  memory  screen  holes  (firmware  loads  values  at  power-up) 


Location         Description 

$0478  $9E  (ACIA  control  reg:  eight  data  +  two  stop  bits, 

9600  baud) 

$0479  $0B  (ACIA  command  reg:  no  parity) 

$047A  $40  (flags:  no  echo,  auto  LF  after  CR,  serial  port) 

Bit        Interpretation 

7  Echo  output  on  display  (0  =  no  echo) 

6  Generate  LF  after  CR  (0  =  no  LF) 

5-1  Always  =  0  (reserved) 

0  1  =  communication  port;  0  =  serial  printer  port 
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Table  7-5  (continued) 

Port  1  screen  hole  locations 


Auxiliary  memory  screen  holes  (firmware  loads  values  at  power-up) 

Location         Description 

$047B  $50  (printer  width:  80  columns) 

Bit         Interpretation  ^ 

7-0       Printer  width  (0  =  do  not  insert  CR) 

Main  memory  screen  holes 

Location  Description 

$0479  Reserved 

$04F9  Reserved 

$0579  Printer  width  (1-255;  0  =  disable  formatting) 

$05F9  Temporary  storage  location 

$0679  Bit  7  =  1  while  the  firmware  is  parsing  a  command 

string 

$06F9  Current  command  character  (initially  Control-I) 

$0779  Bit  7  =  1  if  echo  to  display  is  on;  bit  6  =  1  if  firmware  is 

to  generate  a  line  feed  after  carriage  return 

$07F9  Current  printer  column 


Changing  port  1  characteristics 

Figure  7-1  is  a  diagram  of  where  the  port  characteristics  are  stored 
and  moved  under  different  circumstances.  You  can  see  the 
following  from  the  figure; 

n  When  the  power  is  first  turned  on,  the  Monitor  reset  firmware 
moves  the  predefined  set  of  port  characteristics  listed  earlier  in 
this  chapter  from  ROM  into  the  auxiliary  memory  screen  holes 
listed  in  Table  7-5. 

n  If  you  specify  new  characteristics  using  the  System  Utilities  disk, 
the  SUD  software  changes  the  values  in  the  auxiliary  memory 
screen  holes.  Your  programs  can  do  the  same  thing. 
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D  The  values  stored  in  the  auxiliary  memory  screen  holes  are 
affected  by  power-on  reset,  but  not  by  either  Open  Apple- 
Control-Reset  or  a  simple  Control-Reset.  This  feature  is 
provided  so  that  a  port  that  has  been  reconfigured  will  remain 
that  way  while  some  other  program  (such  as  an  application 
program)  is  started  up.  (See  Figure  7-1.) 

D  PR#1  causes  the  firmware  to  move  the  characteristics  stored  in 
the  auxiliary  memory  screen  holes  into  the  main  memory  screen 
holes. 

n  A  program  can  change  values  in  the  main  memory  screen  holes 
directly.  However,  the  only  value  guaranteed  to  be  in  the  same 
place  for  the  entire  Apple  II  series  is  the  line  length  in  main 
memory  location  $0579. 

D  The  firmware  uses  the  port  as  it  is  defined  in  the  main  memory 
screen  holes  at  any  given  time.  You  should  use  the  commands 
listed  in  Table  7-2  to  change  them. 


Porti 

Values  in 

Firmware  Locations 


System  Utilities  Disi< 

PIN  Number  Selection 

(See  Appendix  H) 


Port  1 

Auxiliary  RAM 

Screen  Holes 

(See  Table  7-5) 


Printer  Port 

Commands 

(See  Table  7-2) 


Porti 

Main  RAM 

Screen  Holes 

(See  Table  7-5) 

Reserved  Screen  Holes 


Figure  7-1 

Diagram  of  port  1  cinaracteristlcs  storage 
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Data  format  and  baud  rate 

Serial  data  transfer  consists  of  a  string  of  I's  and  O's  sent  down  a  wire 
at  a  prearranged  rate  of  transmission,  called  the  baud  rate. 

Before  transfer  begins,  both  sender  and  receiver  look  for  a 
continuous  value  of  1:  this  is  called  the  carrier  (Figure  7-2).  When 
the  value  goes  to  0,  the  receiver  presumes  it  is  a  start  bit — that  is,  the 
bit  that  designates  the  beginning  of  a  character  of  data.  If  it  lasts 
longer  than  a  bit  could  possibly  last,  it  is  considered  a  BREAK 
signal,  which  some  printers  use  for  synchronization. 

If  the  first  0  proves  to  be  a  bit,  it  is  interpreted  as  the  start  bit.  Next 
come  the  seven  or  eight  data  bits  (six  is  seldom  used  with 
computers),  low-order  bit  first.  If  parity  is  on,  it  comes  next  in  the 
message.  Finally,  one  or  two  stop  bits  appear.  The  stop  bits  have  a 
value  of  1,  like  the  carrier.  The  next  start  bit  begins  transfer  of  the 
next  character  of  data. 

The  parity  bit  provides  a  simple  check  of  data  validity.  Odd  parity 
means  the  sender  counts  the  number  of  I's  among  the  data  bits,  and 
sends  the  appropriate  parity  bit  to  make  the  total  number  of  I's 
odd.  With  even  parity,  the  sender  adds  the  appropriate  parity  bit  to 
make  the  total  number  of  1  bits  even.  MARK  parity  is  always  a  1  bit; 
SPACE  parity  is  always  a  0.  The  receiver  can  then  check  that  the 
parity  bit  is  correct. 

If  the  baud  rate  is  300  and  the  data  format  is  one  start  bit  plus 
seven  data  bits  plus  one  parity  bit  plus  one  stop  bit  (totaling  ten  bits 
transmitted  for  each  byte  of  data  sent),  then  the  actual  transfer  rate 
is  about  30  characters  per  second. 


n 


=  1  or  MARK 


1  Start  +  • 


or  SPACE 


r  No  "1 

r     N 

7 

Odd 

1 

Data  +  • 

Even 

.  Parity  +  • 

8 

MARK 

2 

SPACE 

^    J 

Stop 


LSB 


ZTU^ 


start 
Bit 


1        1 


_0_^ 


MSB  Carrier 

I    .   I 


1 


V""!^ 


Odd    Stop  Next 

Parity  Bit  Start 

Bit 


ASCii  letter  M  =  $4D;  sent  as  8  data,  odd  parity,  1  stop  bit 


Figure  7-2 

Data  forinat 
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Carriage  return  and  line  feed 

If  you  are  vising  a  typewriter  and  you  push  the  carriage  all  the  way  to 
the  right  (in  other  words,  position  the  printing  mechanism  at  the 
left  margin),  you  have  performed  a  carriage  return.  On  the  other 
hand,  turning  the  platen  so  the  paper  moves  to  the  next  line  (or 
using  the  index  key  on  an  electric  typewriter)  is  called  a  line  feed. 
Most  typewriters  perform  a  line  feed  automatically  after  a  carriage 
return,  and  so  the  two  seem  to  be  one — but  they  are  not. 

Carriage  return  and  line  feed  are  separate  ASCII  codes.  Carriage 
return  is  sometimes  denoted  CR;  it  is  ASCII  code  13  C$OD).  Line 
feed,  sometimes  denoted  LF,  is  ASCII  code  10  ($0A).  Down  Arrow 
on  the  Apple  He  keyboard  generates  a  LF. 

Some  printers  can  supply  a  line  feed  automatically  after  detecting  a 
carriage  return-,  others  cannot.  If  the  printer  does  not  supply  a  line 
feed  after  a  carriage  return  and  it  is  not  supplied  in  the  data  stream, 
the  printer  keeps  printing  over  and  over  on  the  same  line.  On  the 
other  hand,  if  both  the  printer  and  the  Apple  lie  firmware  supply  LF 
after  CR,  double  line-spacing  results. 

If  the  print  head  keeps  moving  too  far  to  the  right  across  the  page 
and  then  prints  many  characters  on  top  of  one  another  on  the  right, 
then  the  firmware  should  be  instructed  to  furnish  CR  after  a  certain 
line  width  has  been  reached.  If  the  printer  prints  too  short  a  line 
before  moving  to  the  next  line,  then  probably  the  firmware  is  using 
too  small  a  line  width. 

If  the  printer  misses  characters  at  the  beginning  of  each  line  but 
otherwise  prints  correctly,  there  is  probably  not  enough  time  for 
the  print  mechanism  to  retum  to  the  left  margin  in  response  to  CR. 
You  must  use  a  lower  baud  rate  with  such  a  printer. 
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Sending  special  characters 

If  you  want  to  send  special  characters  (control  characters)  to  the 
printer  without  having  them  intercepted  and  executed  by  the 
Apple  lie  firmware,  use  the  Z  command  (see  Table  7-2).  If  the  only 
special  character  that  causes  a  problem  is  the  command  character 
(normally  Control-I  for  port  1),  you  can  change  just  the  command 
character  instead  of  using  the  zap  (Z)  command.  If  you  use  the  zap 
command,  the  firmware  does  no  formatting;  that  is,  it  does  not 
check  line  width  or  insert  carriage  returns  or  line  feeds.  This  may  be 
necessary  to  send  graphics  to  a  printer  or  plotter. 


Dispiaying  output  on  ttie  screen 

You  can  display  printer  output  on  the  screen,  but  if  the  printer  line 
width  exceeds  the  40  or  80  columns  you  have  selected  for  display, 
you  should  turn  off  video  display. 
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Serial  I/O 
Port  2 
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Serial  port  2  is  one  of  two  serial  I/O  ports  available  on  the 
Apple  lie.  It  is  intended  primarily  as  a  communication  port  for 
modems.  You  can  change  it  to  a  serial  printer  port  Oike  port  1) 
using  the  System  Utilities  disk  or  from  a  program. 


Warning     Although  the  Apple  He  serial  ports  are  similar  to  the  Apple  lie 
Super  Serial  Card,  there  are  important  differences.  Refer  to 
Appendix  F  for  a  summary  of  these  differences. 

Table  8-1  summarizes  the  characteristics  of  this  port  and  is  a  guide 
to  the  other  information  in  this  chapter.  If  you  change  port  2  to  a 
serial  printer  port,  refer  to  the  descriptions  in  Chapter  7  and  use  2 
instead  of  1  for  the  port  number  when  required. 

The  serial  port  connectors  are  described  in  Chapter  11. 

Table  8-1 

Serial  port  2  characteristics 


Port  number 
Commands 


Serial  port  2. 

Keyboard  commands: 
IN#2  before  Table  8-2  commands, 
IN#2  to  accept  port  2  input, 
PR#1  to  echo  input  to  printer, 
PR#2  to  echo  input  bads  to  port  2. 

BASIC  commands:  same. 


Initial  characteristics 

Hardware  page 
locations 


Monitor  command:  2  Control-P 
(does  not  work  if  there  is  an  operating 
system  in  RAM). 

All  other  commands:  see  Table  8-2. 

See  "Characteristics  of  Port  2  at  Startup." 

See  Table  8-3. 


Monitor  firmware 
routines 


None. 


I/O  firmware 
entry  points 


See  Table  8-4. 
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Table  8-1  (continued) 
Serial  port  2  characteristics 


Use  of  screen  holes 


See  Table  8-5. 


Use  of  other  pages 


In  terminal  mode,  firmware  uses  auxiliary 
memory  locations  $0800-$087F  to  store 
keyboard  input,  and  $088(>-$08FF  as  a 
serial  input  buffer. 


Using  serial  port  2 

You  can  access  the  firmware  from  BASIC  in  the  usual  way — that  is, 
by  issuing  Control-D  (if  DOS  or  ProDOS  is  in  RAM)  followed  by 
IN#2  or  PR#2.  Subsequent  input  and  output  are  routed  through  the 
modem  (or  other  device)  connected  to  serial  port  2. 


Important 


Refer  to  Table  8-4  for  the 
standard  firmware  entry  points 
that  Pascal  1.1  and  1.2  use. 


In  terminal  mode,  tine  modem  port  commands  listed  In  Table  8-2 
must  follow  Control-D  and  iN#2  (not  PR#2)  and  the  command 
character  (which  Is  usually  Controi-A). 

To  transfer  files  to  the  modem  under  Pascal,  specify  REMOUT: 
or  #8:.  To  transfer  files  from  the  modem  under  Pascal,  specify 
REMIN:   or  #7:. 

Table  8-2  lists  the  commands  you  can  use  with  serial  port  2,  either 
from  a  program  or  from  the  keyboard,  after  you  issue  IN#2. 


UnlDlsk  3.5     Commands  followed  by  an  asterisk  in  Table  8-2  (with  the 
exception  of  L)  are  available  only  on  the  version  of  the 
Apple  lie  that  supports  UnlDisk  3.5.  These  commands  can  be 
toggled  by  following  them  directly  with  E  (enable)  or  D 
(disable). 

Each  command  must  be  preceded  by  Control-A  (the  command 
character).  As  soon  as  you  issue  the  command  character,  the  serial 
port  firmware  displays  a  flashing  question  mark  cursor  to  indicate  it 
is  awaiting  a  command.  If  you  press  Return,  you  get  the  current 
video  cursor  again.  You  do  not  have  to  press  Return  (or  send  a 
return  character)  after  commands.  You  can  type  more  than  one 
command  on  a  line,  but  each  must  be  preceded  by  the  command 
character. 
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Table  8-2 

Modem  port  commands 


Command       Description 


nnn 


nnB 


nD 


I 

K 

L* 


Sets  new  line  width  of  nnn  (from  1  through  255);  this 
must  be  followed  immediately  by  N  (see  below)  or  by 
carriage  return. 

Sets  baud  rate  to  value  corresponding  to  nn: 


nn 

Rate 

nn 

Rate 

nn 

Rate 

J 

50 

6 

300 

11 

3600 

2 

75 

7 

600 

12 

4800 

3 

110  (109.92) 

8 

1200 

13 

7200 

4 

135  (134.58) 

9 

1800 

14 

9600 

5 

150 

10 

2400 

15 

19200 

When  enabled,  this  command  causes  a  carriage 
return  character  to  be  sent  automatically  whenever  the 
colunm  count  exceeds  the  printer  line  width.  The 
command  is  normally  enabled. 

Sets  data  format  to  values  corresponding  to  n: 


n 

Data 
bits 

stop 
bits 

n 

Data 
bits 

Stop 
bits 

0 

8 

1 

4 

8 

2 

1 

7 

1 

5 

7 

2 

2 

6 

1 

6 

6 

2 

3 

5 

1 

7 

5 

2 

When  this  corrunand  is  enabled,  your  Apple  lie 
accepts  data  from  the  keyboard  as  well  as  from  the 
serial  port.  You  can  use  this  to  disable  the  keyboard 
before  receiving  or  sending  data  to  prevent  accidental 
keystrokes  from  disrupting  the  data  flow.  Be  sure  that 
your  program  reenables  the  keyboard  when  the  data 
transfer  is  complete.  This  command  is  available  only 
from  BASIC  and  is  normally  enabled. 

Echoes  output  on  the  screen. 

Disables  automatic  line  feed  after  carriage  return. 

Generates  line  feed  after  carriage  return.  Normally, 
this  command  is  enabled.  Disabling  it  has  the  same 
effect  as  the  K  command. 
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Table  8-2  (continued) 
McxJem  port  commands 


Command       Description 


M' 


nnnN 


nP 


Q 

R 


Control-T 


When  this  command  in  enabled,  all  incoming  line 
feed  characters  are  masked  (removed  from  the  data 
stream).  Normally  this  command  is  enabled. 

Sets  line  width  to  nnn  (from  1  through  255);  does  not 
echo  output  on  the  screen.  Note:  ON  does  not  disable 
automatic  generation  of  carriage  return;  to  do  so,  use 
the  Z  command,  put  0  directly  in  location  $057A,  or 
use  the  System  Utilities  disk. 

Sets  parity  corresponding  to  n: 


n 

Parity 

n 

Parity 

0 

none 

4 

none 

1 

odd 

5 

MARK  (1) 

2 

none 

6 

none 

3 

even 

7 

SPACE  (0) 

Quits  terminal  mode. 

Resets  port  2  and  exits  from  serial  port  2 
firmware. 

Sends  a  233-millisecond  BREAK  character. 

Enters  terminal  mode.  Use  this  command  after  IN#2 
only.  Also,  if  you  follow  this  command  by  PR#2,  the 
Apple  lie  echoes  input  to  output.  Of  the  other  device 
does  so  too,  the  first  character  loops  endlessly, 
locking  up  the  system.  Use  Control-Reset  to  get  out.) 

When  enabled,  this  command  turns  on  the 
XON/XOFF  protocol:  the  Apple  lie  looks  for  the 
XOFF  ($13)  character  and  responds  by  halting 
transmission  until  an  XON  ($11)  is  received. 
Normally  this  command  is  disabled. 

Zaps  (ignores)  further  command  characters  until 
Control-Reset.  Does  not  format  output  or  insert 
carriage  returns  into  output  stream. 

This  command  from  a  remote  device  puts  the 

Apple  lie  in  terminal  mode  if  IN#2  is  already  in  effect. 

It  is  the  same  as  Control-A  T  typed  locally. 
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Table  8-2  (continued) 
Modem  port  commands 


Command       Description 


Control-R      This  command  from  a  remote  device  undoes  the 
terminal  mode  command.  If  IN#2  and  PR#2  are  in 
effect,  the  remote  keyboard  and  display  become  the 
input  and  output  devices  of  the  local  Apple  lie.  It  is 
the  same  as  Control-A  Q  typed  locally. 

Note:  The  commands  themselves  are  letter  commands,  not  control 

characters. 

*  Ckammand  (with  the  exception  of  L)  available  only  on  the  version  of  the 
Apple  lie  that  supports  UniDisk  3.5.  Command  can  Be  toggled:  If  you 
follow  the  command  with  E  (with  no  intervening  space)  the  command  is 
enabled.  If  you  follow  the  command  with  D  (with  no  intervening  space) 
the  command  is  disabled.  The  L  command  is  available  on  the  earlier 
Apple  lie,  but  it  cannot  be  toggled  there. 

When  the  Apple  lie  is  turned  on,  the  serial  port  2  command 
character  is  defined  as  a  Control-A.  You  can  change  it  to  a  different 
control  character  by  typing  the  current  control  character  followed 
immediately  by  the  new  control  character  you  want.  This  is  useful  if 
you  want  to  be  able  to  send  Control-A  to  the  output  device  without 
firmware  intervention. 

For  example,  to  change  the  command  character  from  Control-A  to 
Control- V,  send  Control-A  Control-V  either  from  the  keyboard  or 
from  a  program.  (Control-V  and  Control-W  are  the  recommended 
substitute  control  characters.)  To  change  the  command  character 
back  again,  send  Control-V  Control-A. 


Warning  Do  not  use  Controi-B,  -C,  -H,  -I,  -J,  -L,  -M.  or  -Y:  Apple  lie 
firmware  may  intercept  these  control  characters,  causing 
unpredictable  results. 

The  following  are  examples  of  valid  commands  and  command 
sequences.  These  examples  show  commands  being  entered  from 
the  keyboard,  but  your  programs  can  send  the  characters  just  as 
well. 

To  enable  echo  to  the  screen: 

Ck)ntrol-A  I 

To  send  a  break  character  to  a  remote  device: 

Control-A  B 
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To  change  the  control  character  to  Control-V  (for  example,  so  you 
can  send  Control-A  as  part  of  a  character  stream): 

Control-A  Control-V  Control-VCcommand) 


Characteristics  of  port  2  at  startup 

After  power-up,  the  firmware  sets  the  following  configuration: 

D  300  baud 

D  eight  data  bits,  no  parity  bits,  one  stop  bit 

n  firmware  does  not  supply  line  feed  after  carriage  return 

n  firmware  does  not  insert  carriage  returns  into  output  stream 

a  firmware  does  not  echo  output  to  the  display  screen 

D  command  character  is  set  to  Control-A 

These  values  are  stored  in  the  auxiliary  memory  screen  holes 
(Table  8-5).  You  can  change  some  of  these  settings  from  the 
keyboard  using  the  command  character  followed  by  one  of  the 
commands  listed  in  Table  8-2.  How  port  characteristics  change  as  a 
result  of  various  activities  is  desaibed  later  in  this  chapter. 

If  you  change  any  of  these  values  using  keyboard  commands  or 
commands  from  a  program,  subsequent  accesses  to  the  port 
firmware  (even  by  another  program)  use  the  new  settings  instead  of 
the  power-up  values.  This  allows  you  to  change  the  settings  once  at 
system  startup  and  get  the  desired  configuration  for  subsequent 
uses. 


Hardware  page  locations  for  port  2 

Table  8-3  lists  for  serial  port  2  the  addresses  of  its  hardware  registers 
on  page  $C0.  The  registers  are  internal  to  a  6551  ACIA;  their  bit 
assignments  are  described  in  Chapter  11. 


Warning     This  table  is  for  your  information  oniy.  To  avoid  liaving  probiems 
witli  your  system,  you  sliouid  never  try  to  directly  access  \he 
hardware.  Instead,  use  ttie  Apple  lie's  built-in  firmware  In  your 
programs. 


Hardv^^are  page  locations  for  port  2  1 73 


Not©  in  Chapter  1 1  that  some 
of  the  bit  assignments  for  this 
port  differ  from  those  for  port  1 . 


Table  8-3 

Port  2  hardware  page  locations 


Location 


Description 


$C0A0-$C0A7 

$C0A8 

$C0A9 

$COAA 

$COAB 

$COAC-$COAF 


Reserved 

ACIA  transmit/receive  data  register 

ACIA  status  register 

ACIA  command  register 

ACIA  control  register 

Reserved 


I/O  firmware  support  for  port  2 

Table  8-4  lists  the  values  in  the  I/O  firmware  protocol  table  for 
serial  port  2.  This  standardized  protocol  is  available  for  use  by  any 
application  program.  Chapter  3  describes  how  to  use  this  protocol. 

Table  8-4 

Port  2  I/O  firmware  protocol 

Address     Value  Description 


$C205 

$38 

$C207 

$18 

$C20B 

$01 

$C20C 

$31 

$C20D 

$ii 

$C20E 

$rr 

$C20F 

$ww 

$C210 

$ss 

$C211 

non- 

zero 

Pascal  ID  byte. 

Pascal  ID  byte. 

Generic  signature  byte  of  firmware  cards. 

Same  ID  as  for  Super  Serial  Card. 

$C2ii  is  entry  point  of  initialization  routine  (Plnit). 

$C2rr  is  entry  point  of  read  routine  (PRead). 

$C2ww  is  entry  point  of  write  routine  (PWrite). 

$C2ss  is  entry  point  of  the  status  routine  (PStatus). 

No  optional  routines. 


The  ACiA  register  bits  are 
defined  in  Chapter  1 1 . 


Screen  tiole  locations  for  port  2 

Table  8-5  lists  the  screen  hole  locations  that  serial  port  2  uses.  Note 
that  the  auxiliary  inemory  locations  are  reserved  for  startup  value 
settings,  which  are  listed  and  interpreted  in  the  table. 
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Table  8-5 

Port  2  screen  hole  locations 


Auxiliary  rtwmory  screen  holes  (firmware  loads  values  at  power-up) 

Location        Description 

$047C  $16  (ACIA  control  reg:  eight  data  +  one  stop  bit, 

300  baud) 

$047D  $0B  (ACIA  command  reg:  no  parity) 

$047E  $01  (flags:  no  echOi  no  auto  LF  after  CR, 

communication  port) 

Bit        Interpretation 

7       Echo  output  on  display  (0  =  no  echo) 
6       Generate  LF  after  CR  (0  =  no  LF) 
5-1       Always  =  0  (reserved) 
0       1  =  communication  port;  0  =  serial 
printer  port 

$047F  $00  Oine  length:  do  not  add  any  CR  to  output  stream) 

Bit         Interpretation 
7-0       Line  length  (0  =  do  not  insert  CR) 

Main  memory  screen  holes 

Location  Description 

$047A  Reserved 

$04FA  Reserved 

$057A  Line  length  (1-255;  0  =  disable  formatting) 

$05FA  Temporary  storage  location 

$067A  Bit  7  =  1  if  and  only  if  the  firmware  is  currently  parsing 

a  command  string 

$06FA  Current  command  character  (initially  Control-I) 

$077A  Bit  7  =  1  if  echo  to  display  is  on;  bit  6  =  1  if  firmware  is 

to  generate  a  line  feed  after  carriage  return 

$07FA  Current  column 
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Changing  port  2  characteristics 

Figure  8-1  is  a  diagram  of  where  the  port  characteristics  are  stored 
and  moved  under  different  circumstances.  You  can  see  the 
following  from  the  figure: 

D  When  the  power  is  first  turned  on,  the  Monitor  reset  firmware 
moves  the  predefined  set  of  port  characteristics  listed  in  Table  8- 
2  from  ROM  into  the  auxiliary  memory  screen  holes  listed  in 
Table  8-5. 

n  If  you  specify  new  characteristics  using  the  System  Utilities  disk, 
the  utility  software  changes  the  values  in  the  auxiliary  memory 
screen  holes. 

n  The  values  stored  in  the  auxiliary  memory  screen  holes  are 
affected  by  power-on  reset,  but  not  by  either  Open  Apple- 
Control-Reset  or  a  simple  Control-Reset.  This  feature  is 
provided  so  that  a  port  that  has  been  reconfigured  wiU  remain 
that  way  while  some  other  program  (such  as  an  application 
program)  is  started  up. 

D  IN#2  causes  the  firmware  to  move  the  characteristics  stored  in  the 
auxiliary  memory  screen  holes  into  the  main  memory  screen 
holes. 

D  A  program  can  change  values  in  the  main  memory  screen  holes 
directly.  However,  the  only  value  guaranteed  to  be  in  the  same 
place  for  the  entire  Apple  n  series  is  the  line  length  in  main 
memory  location  $057A. 

n  The  firmware  uses  the  port  as  it  is  defined  in  the  main  memory 
screen  holes  at  any  given  time.  You  should  use  the  commands 
listed  in  Table  8-2  to  change  these  characteristics. 
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System  Utilities  Disk 

PIN  Number  Seiectlon 

(See  Appendix  H) 


Port  2 

Values  in 

Firmware  Locations 


Communication  Port 

Commands 

(See  Table  8-2) 


Port  2 
Auxiliary  RAM 
Screen  Holes 
(See  Table  8-5) 


Port  2 

Main  RAM 

Screen  Holes 

(See  Table  8-5) 


Figure  8-1 

Diagram  of  port  2  characteristics  storage 


Data  format  and  baud  rate 

Chapter  7  describes  data  format  and  baud  rate,  and  explains  how 
they  apply  to  printers.  Refer  to  that  chapter  for  definitions  of  terms. 

A  noteworthy  characteristic  of  data  communication  is  its 
strangeness:  sometimes  the  oddest  changes  make  a  given 
communication  arrangement  work  or  not  work.  You  must  keep  this 
notion  firmly  in  mind  when  working  with  serial  port  2. 

For  example,  modem  communication  involves  quite  a  few  elements 
(Figure  8-2): 

n  the  Apple  lie  and  its  firmware,  with  the  baud  rate,  data  format, 
and  other  characteristics  you  have  selected 

D  the  cable  from  the  Apple  lie  to  the  modem 

D  the  modem 

D  possibly  an  acoustic  coupler  for  a  telephone  handset 
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n  the  telephone  lines,  with  their  switching  equipment,  boosters, 
and  noise 

D  some  combiiution  of  modem,  cable,  and  remote  computer  or 
terminal 

As  you  can  imagine,  some  method  is  required  for  successful  data 
transmission.  If  you  have  problems,  change  only  one  variable  at  a 
time  and  then  cycle  through  the  other  variables  one  at  a  time.  Take 
nothing  for  granted.  The  data  format  advertised  for  an  information 
service,  for  example,  may  be  different  from  the  one  you  end  up 
using  with  the  Apple  lie 


Local  DTE 

(Data  Terminal 

Equipment) 


Local  DOE 

(Data  Communication 

Equipment) 


Transmission  Line 


Remote  DOE 


Remote  DTE 


Figure  8-2 

Devices  in  a  typicai  communication  setup 
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Carriage  return  and  line  feed 

If  you  are  communicating  with  a  computer  or  terminal,  carriage 
return  and  line  feed  may  or  may  not  be  involved.  Start  off  without 
generating  them,  and  turn  on  automatic  generation  only  as  needed. 
They  are  described  as  used  with  printers  in  Chapter  7. 


-or  a  further  description  of  what 
terminal  mode  does  and  how  to 
get  Into  and  out  of  It,  refer  to 
fhe  last  section  of  this  chapter. 


Routing  input  and  output 

This  section  discusses  the  possible  ways  that  serial  port  2  can  route 
information.  Sometimes  the  cause  of  communication  problems  is 
that  information  is  not  going  where  you  think  it  is,  or  it  is  and  you 
cannot  see  evidence  of  the  fact.  Figures  8-3  through  8-6  show  some 
of  the  patterns  of  information  flow  you  can  select 

It  is  best  to  read  all  this  material  as  a  unit;  questions  that  arise  while 
you  read  one  description  may  be  answered  elsewhere. 

The  simplest  serial  port  2  command  is  IN#2  (Figure  8-3).  Port  2 
becomes  the  input  device.  Data  coming  into  the  port  gets  passed  to 
the  input  buffer  (page  $02  of  main  memory).  Applesoft  firmware 
and  system  software  can  see  the  data  and  carry  out  commands  in  the 
normal  way. 

Of  course,  you  can  also  use  just  the  PR#2  command — for  example, 
if  you  want  to  send  a  listing  to  the  modem. 

To  use  port  2  for  data  communication,  you  ordinarily  put  it  into 
terminal  mode.  Following  IN#2,  pressing  Control-A  gets  the 
attention  of  the  port  2  firmware,  which  displays  a  blinking  question 
mark  (?)  as  a  prompt  Now  type  T  to  put  the  computer  in  terminal 
mode.  In  this  mode,  the  firmware  displays  a  blinking  underscore 
character  (  _  )  as  a  prompt. 

In  the  discussion  that  follows,  loccU  refers  to  your  Apple  lie. 
Remote  refers  to  some  other  device,  usually  in  a  distant  location 
and  at  the  other  end  of  a  communication  link.  The  remote  device 
can  be  any  ASCII-generating  unit  a  terminal  or  a  computer. 

If  a  remote  computer  is  another  Apple  lie  or  an  Apple  II  series 
machine  with  a  Super  Serial  Card  in  it,  then  most  of  the  commands 
described  here  apply  to  it  as  well. 
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Display 


a 


\ 


Printer 


Q 


Communication 
Device 


^^ 


Remote 

Communication 

Device 


1        ||vid 


T" 


Port  1 
FW 

MON 

-•— -» 


Remote 

Terminal 

or  Computer 


Keyboard 


Figure  8-3 

Effect  of  IN#2 


Half-duplex  operation 

In  half-duplex  operation,  information  can  flow  from  A  to  B  or 
from  B  to  A,  but  in  only  one  direction  at  a  time.  In  a  half-duplex 
setup,  the  host  does  not  echo  back  to  the  terminal  what  the  terminal 
sends  it  For  half-duplex  operation,  use  IN#2  and  Control-A  T 
(Figure  8-4)  whether  the  Apple  lie  is  the  host  or  the  terminal. 
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IN#2  plus  Control-A  T  is  the  best  way  to  set  up  the  computer  for 
auto-answer  operation.  The  T  command  allows  port  2  firmware  to 
exchange  information  with  the  local  modem  without  interference 
from  the  local  firmware  or  system  software.  (The  remote  device  can 
always  cancel  the  T  command  with  Control-R  if  necessary,  and 
restore  terminal  mode  with  Control-T.)  Avoiding  PR#2  at  this  point 
means  that  the  Apple  lie  can  operate  as  a  half-duplex  terminal, 
half-duplex  host,  or  full-duplex  terminal.  (The  remote  device  can 
also  issue  Control-A  PR#2  if  PR#2  is  required  at  the  local 
computer.) 
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Printer 
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Remote 

Terminal 
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Keyboard 


Figure  8-4 

Effect  of  IN#2  and  T  command,  half  duplex 


In  half-duplex  operation,  the  output  hook  is  available  for  other 
uses.  For  example,  you  can  issue  PR#1  to  print  incoming  messages 
from  port  2.  Use  the  Control-A  I  command  to  display  information 
on  the  screen. 
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Full-duplex  operation 

In  full-duplex  operation,  information  can  flow  from  A  to  B  and 
from  B  to  A  simultaneously.  Typically,  one  of  the  computers  (the 
host  computer)  echoes  its  input  to  output,  so  the  other  computer 
(the  terminal)  can  easily  verify  that  the  communication  is  taking 
place. 

Figure  8-5  shows  the  flow  of  information  when  the  Apple  lie  is  a  full- 
duplex  terminal.  (The  setup  commands,  IN#2  and  Control-A  T,  are 
the  same  as  for  half  duplex.) 
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Figure  8-5 

Effect  of  IN#2  and  T  comnnand,  full-duplex  terminal 


If  your  Apple  lie  is  the  terminal  in  full-duplex  operation,  use  the 
N  command  to  turn  off  echoing  input  to  tiie  screen.  If  the  Apple  lie 
does  echo  input  to  the  screen  in  this  setup,  everything  you  type  will 
appear  twice:  once  from  the  Apple  lie  and  once  from  the  host 
computer. 
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In  this  mode  of  operation,  if  you  echo  input  to  the  printer  yOu  can 
get  a  printed  record  of  both  sides  of  the  communication  session: 
the  input  from  the  host,  and  the  Apple  lie  output  as  echoed  by  the 
host. 

,  Figure  8-6  shows  the  flow  of  information  when  the  Apple  lie  is  a  full- 
duplex  host.  In  this  case,  the  local  Apple  lie  must  echo  input  to 
output  for  the  remote  device.  The  setup  commands  include  PR#2  in 
this  case. 
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Figure  8-6 

Effect  of  IN#2,  PR#2,  and  T  command,  full-duplex  host 


Warning      If  the  Apple  lie  echoes  input  to  output  and  the  other  computer 
does  too,  then  the  first  subsequent  keypress  will  echo  back  and 
forth  endlessly  and  lock  up  the  Apple  lie.  This  wiii  require  a 
Control-Reset  to  get  out. 

if  you  echo  input  to  output  when  using  an  Information  service, 
the  host  will  end  up  seeing  the  echo  of  what  It  sent  you  as 
though  you  had  typed  it, 
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In  this  arrangement,  the  local  output  hook  is  not  available  for  using 
the  printer  or  other  device.  To  display  keyboard  and  port  2  input 
on  the  screen,  issue  Control-A  I. 

Terminal  mode 

Terminal  mode  makes  the  Apple  lie  act  like  a  dumb  terminal — one 
that  just  sends  and  receives  information,  but  does  not  process  it. 
Input  and  output  flow  through  special  serial  I/O  buffers  on  page  $08 
of  auxiliary  memory.  Applesoft  firmware  and  system  software 
cannot  see  or  interpret  the  data:  only  the  serial  port  2  firmware 
deals  with  it. 

In  most  terminal  mode  setups,  the  firmware  will  not  display  port  2 
input  unless  you  use  the  Control-A  I  command. 

Warning     When  using  terminal  mode.  $0800-$08FF  of  auxliiary  i^l\/l  is 
used  for  buffering.  Any  data  stored  tiiere  \A^il  be  overwritten 
wtien  terminal  mode  is  enabled. 

Control-A  T  turns  on  terminal  mode,  and  Control-A  Q  turns  it  off 

The  remote  device  can  go  into  terminal  mode,  and  then  turn  off  the 
local  Apple  He's  terminal  mode  with  the  Control-R  command.  If  it 
then  issues  Control-A  PR#2,  local  output  will  go  to  the  remote 
device.  The  remote  keyboard  and  display  then  become  the  input 
and  output  devices  of  the  local  Apple  lie  processor.  This  is  remote 
mode. 

In  remote  mode,  the  local  Apple  lie  does  not  use  the  serial  I/O 
buffers  (as  it  does  in  terminal  mode);  therefore,  local  firmware  and 
system  software  detect  and  interpret  all  input  and  output  data.  So, 
for  example,  if  you  type  CATALOG  at  the  remote  device  keyboard, 
the  local  Apple  lie  will  execute  the  command  and  list  the  disk 
catalog  on  the  remote  device's  display.  On  terminal  mode,  the 
local  computer  would  simply  display  the  word  CATALOG  on  its 
screen.) 

The  remote  device  can  turn  the  local  Apple  He's  terminal  mode 
back  on  with  Control-T.  Control-A  T  issued  at  the  remote  device 
only  turns  on  the  remote  device's  terminal  mode,  unless  the 
command  character  there  has  already  been  changed  to  something 
else. 
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This  chapter  describes  the  Apple  He's  mouse  port  and  hand 
controller  (game)  input  capabilities.  The  mouse  and  hand 
controllers  use  the  same  9-pin  connector  on  the  back  panel;  the 
firmware  uses  the  port  as  directed  by  keyboard  or  program 
commands. 


Mouse  input 

Table  9-1  summarizes  the  mouse  port's  characteristics  and  guides 
you  to  other  information  in  this  part  of  the  chapter. 


Warning      If  you  want  your  programs  that  use  the  mouse  on  the  Apple  lie 
and  other  Apple  II  series  computers  to  work  with  the  Apple  lie, 
always  use  the  I/O  firmware  entry  points  listed  In  Tables  9-4 
and  9-5,  rather  than  dealing  directly  with  the  mouse  hardware 
and  RAM  locations. 

The  mouse  back  panel  connector  is  described  in  Chapter  11. 


Table  9-1 

Mouse  Input  port  characteristics 


Port  number 
BASIC  commands 


Initial  ctiaracteristics 


Hardware  page 
locations 

Monitor  firmware 
routines 

I/O  firmware 
entry  points 

Use  of  screen  tioies 


Mouse  input  port  4. 

Turn  on  mouse: 

PRINT  CHR$C4)"PR#4":PRINT  CHR$C1) 

Turn  off  mouse  interrupts: 
PRINT"PR#4":PRINT  CHR$(0) 

Turn  on  graphics  character  set:  See 
"MouseText"  in  Chapter  5. 

After  a  reset,  all  mouse  interrupts  are  off 
and  the  rising  edge  of  XO  and  YO  are 
selected  for  interrupts. 

See  Table  9-2. 


None. 


See  Tables  9-3  and  9-4. 


See  Table  9-5. 
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Memory  expansion  The  memory  expansion  version  of  tlie  Appie  lie  places  the 
mouse  at  Input  port  7  and  ttie  memory  expansion  card  at 
port  4.  Ihus,  all  '"PR4"  entries  become  "PR?'  entries. 


Mouse  connector  signals 

The  mouse  uses  the  same  DB-9  connector  as  the  hand  controllers. 
However,  the  interpretation  of  the  signals  arriving  on  the  pins 
differs  depending  on  the  commands  and  signals  received. 
Figure  11-37  shows  the  names  of  the  pin  assignments  when  a  mouse 
is  connected. 


Mouse  operating  modes 

This  section  tells  what  the  mouse  operating  modes  are  for.  Later 
sections  of  this  chapter  describe  how  to  set  the  various  mouse 
operating  modes. 

Your  program  should  call  the  ServeMouse  routine  to  determine  the 
source  of  an  interrupt  as  soon  as  it  receives  one,  in  all  the  interrupt 
modes  except  transparent  mode. 


Transparent  mode 

In  transparent  mode,  your  program  must  read  screen  holes  to  check 
for  mouse  movement.  An  interrupt  routine  in  the  Apple  He 
firmware  updates  mouse  position  counters  each  time  the  mouse  is 
moved,  then  returns  control  to  the  main  program  task.  The  findings 
of  the  interrupt  routine  are  placed  in  the  screen  holes  for  your 
program  to  find.  Table  9-5  lists  the  screen  holes  with  the 
information  that  your  program  should  look  for. 

This  is  the  only  mouse  mode  available  to  BASIC  programs. 


Movement  interrupt  mode 

On  the  Apple  lie,  a  signal  called  VBlInt  can  interrupt  the  processor 
whenever  a  video  vertical  blanking  signal  occurs.  This  can  make  it 
easier  for  your  programs  to  smoothly  move  the  mouse  cursor  in 
response  to  mouse  movements. 
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"MouseTexf  in  Chapter  5 
contains  recommendations  for 
using  l\/louseText  cliaracters 
witin  a  mouse. 


In  movement  intermpt  mode,  the  mouse  firmware  armis  VBlInt 
whenever  the  mouse  is  moved  at  least  one  count  in  any  direction. 
When  VBlInt  occurs,  program  control  passes  to  the  vector  address 
contained  at  locations  $03FE  and  $03FF;  the  interrupt  handler  in 
your  program  can  then  update  the  cursor  smoothly  to  its  next 
screen  position. 

Your  program's  interrupt  handler  must  first  call  ServeMouse 
(Table  9-3)  to  see  if  the  mouse  caused  the  interrupt.  It  should  then 
call  ReadMouse  to  get  mouse  status  and  its  current  X-Y  position. 
The  routine  can  also  change  the  mouse  mode  and  position  if 
desired. 

The  maximum  amount  of  mouse  movement  that  can  occur  between 
successive  VBlInt  interrupts  is  limited  to  the  distance  someone  can 
move  a  mouse  in  one-sixtieth  of  a  second. 


Button  intermpt  mode 

The  Apple  lie  mouse-button  hardware  location  does  not  generate 
interrupts.  However,  a  program  can  simulate  mouse-button 
interrupts  by  polling  the  button  whenever  VBlInt  occurs,  and  acting 
on  the  interrupt  whenever  the  button  state  has  changed.  This  lets 
your  program  provide  fast  response  to  the  mouse  movement 
without  too  much  program  overhead. 


Movement/button  interrupt  mode 

The  movement/button  interrupt  mode  is  a  combination  of  the  two 
modes  just  described.  It  provides  the  best  response  possible  without 
constant  polling  of  the  mouse  position  and  button.  Your  program 
can  effectively  process  a  main  task  concurrently  with  cursor  and 
menu  updating,  as  well  as  menu-selected  command  processing. 


Vertical  blanl(ing  active  modes 

The  vertical  blanking  active  modes  are  the  same  as  the  four  just 
described  except  that  they  allow  VBL  interrupts  to  be  sent  to  the 
user. 
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Mouse  soft  switches 


Appendix  E  explains  how  the 
firmware  liandies  interrupts. 


The  soft  switches  assigned  to  the  mouse  interface  are  shown  in 
Table  9-2.  On  power-up  or  reset,  the  hardware  selects  the  rising 
edge  of  XO  and  YO  (mouse  movement  signals)  and  masks  out  all 
mouse  interrupts. 


Warning 


Table  9-2  is  Inciuded  here  for  your  information  only.  You  should 
use  Vrte  built-in  firmware  to  access  the  mouse;  doing  so  is  much 
easier  than  writing  your  own  mouse  Interrupt  handler  and 
guarantees  compatibility  with  all  other  Apple  ll-series 
computers. 


Table  9-2 

Mouse  soft  switches 


Nome 


Action 


Hex 


Function 


lOUDis 


lOUDis 


W 


W 


$C07E 


$C07F 


RdlOUDis 

R7 

$C07E 

DisXY 

R/W 

$C058 

EnbXY 

R/W 

$C059 

RdXYMsk 

R7 

$C040 

RstXY 

R 

$C048 

XOEdge 

R/W 

$C05 

XOEdge 

R/W 

$C05D 

RdXOEdge 

R7 

$C042 

RstXInt 

R 

$C015 

On:  Disable  lOU  access  for 

addresses  $C058  to  $C05F; 

enable  access  to  DHiRes 

switch* 

Off:  Enable  lOU  access  for 

addresses  $C058  to  $C05F; 

disable  access  to  DHiRes 

switch* 

Read  lOUDis  switch  (1  =  ofOt 

Disable  (mask)  XO  and  YO 
movement  interrupts^  • 
Enable  (allow)  XO  and  YO 
movement  interrupts^ 
Read  status  of  XO/YO  interrupt 
mask  (1  =  mask  on) 
Reset  XO/YO  interrupt  flags 

Select  rising  edge  of  XO  for 

interrupt!: 

Select  falling  edge  of  XO  for 

interrupt^: 

Read  status  of  XO  edge  selector 

(1  =  falling) 

Reset  mouse  XO  interrupt  flag 
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Table  9-2  (continued) 
Mouse  soft  switches 


Name 


Action 


Hex 


Function 


Select  rising  edge  of  YO  for 

intermpt^: 

Select  falling  edge  of  YO  for 

interrupti: 

Read  status  of  YO  edge  selector 

(1  =  falling) 

Reset  mouse  YO  interrupt  flag 

Disable  (mask)  VBL 

interruptst 

Enable  (allow)  VBL  interrupts^ 

Read  status  of  VBL  interrupt 

mask  (1  =  mask  on) 

Read  and  then  reset  VBlInt 

flag 

Reset  VBlInt  flag;  trigger 

paddle  timer 

Read  first  mouse  button  status 
(1  =  pressed)? 

$C063     Read  second  mouse 
button  status  (0  =  pressed)"! 
Read  status  of  XI  (mouse 
X  direction)  (1  =  high) 
Read  status  of  Yl  (mouse 
Y  direction)  (1  =  high) 

*   When  lOUDis  is  on,  $C058-$C05F  do  not  affect  mouse,  and  $C05E 

and  $C05F  become  DHiRes  (Table  5-8). 
t   Read  or  write  to  $C07x  also  resets  VBlInt  and  triggers  paddle  timers. 
t  These  work  only  if  lOUDis  is  off. 
S  This  location  is  also  the  Open  Apple  key  (Table  4-1). 
<I  This  is  also  the  location  of  the  Shift-key  mod  (Appendix  F). 

Mouse  firmware  sets  interrupts  in  response  to  mode  settings  under 
program  control.  The  vertical  blanking  interrupt  (VBlInt)  is  armed 
if  the  mouse  button  is  pushed  or  moves  at  least  a  count  of  1  in  the 
XO  or  YO  coordinates.  Read  $C070  to  reset  the  VBL  interrupt. 
Because  a  VBL  occurs  every  sixtieth  of  a  second,  that  is  the 
maximum  time  that  can  elapse  before  the  resulting  interrupt  can  be 
acknowledged  and  acted  upon. 

Software  can  also  select  which  edge  of  XO  and  YO  information  will 
cause  the  XInt  or  YInt. 


YOEdge 

R/W 

$C05E 

YOEdge 

R/W 

$C05F 

RdYOEdge 

R7 

$C043 

RstYInt 

R 

$C017 

DisVBl 

R/W 

$C05A 

EnVBl 

R/W 

$C05B 

RdVBlMsk 

R7 

$C041 

RstVBl 

R 

$C019 

PTrig 

R/W 

$C070 

RdBtnO 

R7 

$C06l 

Rd63 

R7 

MouXl 

R7 

$C066 

MouYl 

R7 

$C067 
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When  an  interrupt  has  occurred,  you  can  read  the  direction  of  the 
mouse's  XI  movement  by  reading  address  $C066  bit  7,  and 
Yl  movement  by  reading  address  $C067  bit  7. 

A  program  can  read  the  status  of  the  soft  switches  by  reading  one  of 
the  locations  $C040-$C043  and  then  testing  data  bit  7.  The  soft 
switches  are  described  in  Table  9-2. 

The  section  on  mouse  input  in  Chapter  11  explains  what  XO,  YO, 
XI,  Yl  are  and  what  they  mean  with  respect  to  mouse  movement. 

If  you  write  your  own  mouse  interrupt  handler,  it  should  enable  the 
main  bank-switched  memory,  set  up  its  own  IRQ  vectors  at 
addresses  $FFFE  and  $FFFF,  keep  track  of  video  modes  and  the 
alternate  stack,  and  check  for  the  interrupt  source  in  the  same 
manner  as  the  mouse  firmware  listed  in  Appendix  I,  beginning  at 
address  $C400. 


Important     The  listing  in  Appendix  i  provides  source  code  only  for  the 

memory  expansion  version  of  the  Apple  lie.  Mouse  code  starts 
at  $C700  in  the  new  ROI\/1.  There  are  instructions  for  obtaining 
listings  for  the  orlgirxal  and  UnlDlsk  3.5  versions  in  Appendix  I. 


UnlDlsk  3.5     The  32K  ROM  includes  a  new  feature  for  programs  that  need  to 
use  mouse  interrupts  for  their  own  purposes.  If  your  program  sets 
bit  7  of  the  mouse  port  mode  byte  at  $07FC  ($C7FF  In  the 
memory  expansion  iic)  to  1 ,  mouse  movement  interrupts  will  be 
passed  to  the  Interrupt  handier  of  your  program.  VBL  interrupts 
will  still  be  handled  by  the  Apple  lie's  firmware.  You  should  use 
this  feature  only  If  the  mouse  firmware  can't  keep  up  with  your 
needs. 


I/O  firmware  support  for  mouse  input 


Memory  expansion     The  memory  expansion  version  of  the  Apple  lie  places  the 

mouse  at  $C700  and  the  memory  expansion  card  at  $C400.  This 
means  that  the  mouse  Is  supported  on  page  $C7  in  the  new 
Apple  lie,  so  change  all  $C4  and  $40  addresses  to  $C7  and  $70. 
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The  Apple  lie  supports  the  mouse  with  firmware  starting  at  address 
$C400.  This  firmware  is  necessary  because  the  mouse  requires  fast, 
transparent  interrupt  processing  to  work  effectively. 

In  assembly  language  you  can  use  direct  firmware  support  for 
sophisticated  mouse  applications.  To  enable  the  mouse,  first  load  a 
mode  byte  into  the  accumulator  (and  $C4  in  X,  $40  in  Y)  and  then 
do  a  JSR  to  the  firmware  routine  called  SetMouse  (Table  9-3).  Valid 
mode  bytes  are  the  following: 

$00  Turns  mouse  off 

$01  Sets  transparent  mode 

$03  Sets  movement  interrupt  mod 

$05  Sets  button  interrupt  mode 

$07  Sets  movement  or  button  interrupt  mode 

$08  Turns  mouse  off,  VBUnt  active 

$09  Sets  transparent  mode,  VBlInt  active 

$0B  Sets  movement  interrupt  mode,  VBlInt  active 

$0D  Sets  button  interrupt  mode,  VBlInt  active 

$0F  Sets  movement  or  button  interrupt  mode,  VBlInt  active 

The  firmware  then  initializes  the  mouse.  To  read  the  current 
position  and  status  of  the  mouse,  first  load  $C4  into  the  X  register, 
load  $40  into  the  Y  register,  save  processor  status,  disable 
interrupts,  and  then  JSR  to  the  firmware  routine  called  ReadMouse 
(Table  9-3),  which  stores  the  information  in  the  port  4  screen  holes 
(Table  9-5). 

Table  9-3  lists  the  mouse  port  firmware  routine  offsets.  Each 
address  contains  the  low  byte  of  the  entry  point  of  the  routine 
described.  The  calling  setup  for  all  routines  (except  ServeMouse)  is 
the  same:  the  X  register  must  contain  $C4,  and  the  Y  register  must 
contain  $40.  When  the  routine  has  finished,  the  A,  X,  and 
Y  register  contents  are  undefined. 


Memory  expansion     The  memory  expansion  version  of  ttie  Apple  lie  places  tfie 
mouse  at  $C7CXD  and  ttie  memory  expansion  card  at  $C400. 
Thus,  all  mouse  firmware  routines  start  at  a  $C7XX  address, 
instead  of  $C4XX. 
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Table  9-3 

Mouse  firmware  routines 


Location 


Offset  for 


Description 


$C412  SetMouse  Sets  the  mouse  mode  to  the  value  in 

the  accumulator. 

Input:  A  register  contains  mode  (see 
$07FC,  Table  9-5)  C$07FF  in  new 
Apple  lie). 

Output:  Carry  bit  =  0  means  mode 
was  legal;  carry  bit  =  1  means  mode 
was  not  legal. 

$C413  ServeMouse  Services  mouse  interrupt  if  needed. 

Input:  X,  Y,  A  registers — doesn't 
matter. 

Output:  Carry  bit  =  0  means  mouse 
caused  the  interrupt;  carry  bit  =  1 
means  something  else  caused  it. 
This  routine  updates  $077C  ($077F  in 
new  Apple  lie)  to  show  which  event 
caused  the  interrupt  (values  in 
Table  9-5). 

$C414  ReadMouse  Updates  screen  holes  to  show  current 

mouse  X-Y  position  and  button 
status;  clears  VBlInt,  button  and 
movement  interrupt  bits  in  the  status 
byte.  Doesn't  reenable  interrupts 
until  after  retrieving  position  values. 
Output:  Carry  bit  =  0. 

$C415  ClearMouse  Sets  the  mouse  position  to  0,  though 

not  necessarily  within  clamping 
boundaries;  leaves  button  and 
intermpt  bits  in  status  byte 
unchanged. 
Output:  Carry  bit  =  0. 

$C4l6  PosMouse  Sets  the  mouse  coordinates  to  new 

values. 
'  Input:  X  and  Y  screen  holes  contain 
new  X  and  Y  positions. 
Output:  Carry  bit  =  0. 
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Table  9-3  (continued) 
Mouse  firmware  routines 


Location 


Offset  for 


Description 


$C417  ClampMouse 


$C418 


HomeMouse 


$C419 


InitMouse 


Sets  new  damping  boundaries  (see 
Table  9-5).  Does  not  affect  mouse 
position  or  update  mouse  position 
screen  holes;  use  ReadMouse  to  do 
that. 

Input  A  register  =  0  means  set  new 
X  boundaries;  A  register  =  1  means 
set  new  Y  boundaries. 
Output:  Carry  bit  =  0. 

Sets  the  internal  mouse  position  to 
the  upper-left  corner  of  the  damping 
window.  Does  not  update  mouse 
position  screen  holes;  use 
ReadMouse  to  do  that. 

Sets  startup  internal  values;  does  not 
update  mouse-position  screen  holes. 
Output:  Carry  bit  =0. 


Here  is  a  sample  sequence  of  events  and  calls: 

1 .  Four  screen  holes  contain  the  mouse's  X  and  Y  coordinates,  and 
one  contains  the  status  of  the  last  mouse  movement  (Table  9-5). 

2.  Call  InitMouse. 

3.  Inhibit  interrupts,  set  up  the  boundaries  you  want,  then  call 
ClampMouse. 

4.  Use  PosMouse,  HomeMouse,  or  ClearMouse  to  position  the 
mouse  where  you  want  it 

5.  Put  the  mouse  mode  (see  address  $07FC  in  Table  9-5)  that  you 
want  to  use  in  the  accumulator,  then  call  SetMouse  (use  address 
$07FF  for  the  new  Apple  lie). 

6.  If  you  have  set  one  of  the  intermpt  modes,  then  when  an  interrupt 
arrives,  call  ServeMouse  to  determine  the  source  of  the  interrupt. 

7.  Disable  interrupts  and  call  ReadMouse.  Retrieve  the  position 
values,  then  reenable  interrupts. 
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Pascal  support 

Table  9-4  lists  the  locations  and  values  of  the  I/O  firmware  protocol 
that  Pascal  1.1  and  later  versions  use.  However,  Pascal  must  use  a 
special  attach  driver  to  support  the  mouse. 


Memory  expansion 


The  memory  expansion  version  of  the  Appie  iic  piaces  the 
mouse  at  $C700  and  the  memory  expansion  card  at  $C400. 
Thus,  aii  mouse  firmware  routines  start  at  a  $C7XX  address, 
instead  of  $C4XX. 


Table  9-4 

iVIouse  port  i/O  firmware  protocol 


Address        Value         Description 


$C405 

$38 

$C407 

$18 

$C40B 

$01 

$C40C 

$20 

$C40D 

$C40E 

$C40F 

$C410 

$C411 

$00 

$C4FB 

$D6 

Pascal  ID  byte 

Pascal  ID  byte 

Generic  signature  byte  of  firmware  cards 

2  =  X-Y  pointing  device;  0  =  identification 
code 

Initialization  routine  (not  implemented; 
returns  error  code) 

Standard  read  routine  (not  implemented; 
returns  error  code) 

Standard  write  routine  (not  implemented; 
returns  error  code) 

Standard  status  routine  (not  implemented; 
returns  error  code) 

Optional  routines  follow 

A  mouse  identification  byte 


BASIC  and  assembly-language  support 


Memory  expansion     The  memory  expansion  version  of  the  Appie  iic  piaces  the 

mouse  at  $C7CXD  and  the  memory  expansion  card  at  $C400.  This 
means  that  all  "'PR4'  or  •iN4'  calls  change  to  *PR7'  or  "IN7" 
calls. 
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In  BASIC  you  must  turn  the  mouse  on  by  printing  PR#4  and  then 
CHR$(1)  before  you  can  get  input  from  the  mouse.  This  sets 
transparent  mode.  After  that,  reenable  video  output  with  PR#3  and 
take  subsequent  input  from  the  mouse  by  issuing  IN#4.  The  first 
input  statement  after  that  (INPUT  X,Y,S)  initiali2es  and  enables  the 
mouse  and  returns  a  three-element  string 

+XXXX, +yyyy, +st 

representing  the  x-coordinate,  y-coordinate,  and  status  digits. 

The  coordinates  will  be  integers  between  0  and  +1023.  These  are 
called  the  clamping  boundaries  of  the  mouse. 

The  sign  preceding  the  status  digits  is  normally  positive;  it  becomes 
negative  when  you  press  a  key  on  the  keyboard. 

The  first  digit,  s,  of  the  status  is  0.  The  second  digit,  t,  of  the  status 
is  1  if  the  mouse  button  is  still  pressed,  2  if  it  was  just  pressed,  3  if  it 
was  just  released,  and  4  if  it  is  still  released. 

To  disable  the  mouse,  use  these  statements: 

PRINT   CHR$(4)"PR#4" 
PRINT   CHR$(0) 
PRINT   CHR(4)'>PR#3" 

Important     Change  all  4's  to  7's  for  ttie  memory  expansion  version. 


Screen  holes 

Table  9-5  lists  the  screen  holes  that  the  mouse  firmware  uses.  Note 
that  the  mouse  firmware  reserves  port  5  screen  holes  for  its  own  use. 
Also,  the  auxiliary  page  counterparts  of  the  port  4  addresses  are 
reserved  for  startup  values. 


Important     Some  screen  holes  are  different  for  the  Apple  lie  mouse.  Refer  to 
Appendix  F. 
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Table  9-5 

Mouse  port  screen  hole  locations 


Scratch  area 

Location 

$0478 
$04F8 
$0578 
$05F8 

Description 

Low  byte  of  damping  minimum 
Low  byte  of  damping  maximum 
High  byte  of  damping  mimimum 
High  byte  of  damping  maximum 

Port  4  screen  holes 

Location 

Description 

$047C 

Low  byte  of  X  coordinate 

$04FC 

Low 

byte  of  Y  coordinate 

$057C 

High  byte  of  X  coordinate 

$05FC 

High  byte  of  Y  coordinate 

$067C 

Reserved 

$06fc 

Reserved 

$077C 

Status  byte 

Bit 

1  Equals 

7 

Button  down 

6 

Button  was  down  on  last  read  and  still  down 

5 

Movement  since  last  read 

4 

Reserved 

3 

Interrupt  from  VBlInt 

2 

Interrupt  from  button 

1 

Interrupt  from  movement 

0 

Reserved 

$07FC  Mode  byte  (current  mode;  mask  out  bits  4-7  when 

testing) 


Bit 

1  Equals 

7-4 

Reserved 

3 

VBlInt  active 

2 

VBL  interrupt  on  button 

1 

VBL  interrupt  on  movement 

0 

Mouse  active 

Port  5  screen  holes 


Reserved 
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Memory  expansion 


The  screen  hole  addresses  for  the  mouse  in  the  Apple  lie  that 
supports  the  memory  expansion  card  all  end  with  F,  Instead  of 
C;  this  is  because  the  mouse  has  moved  to  slot  7  from  slot  4.  For 
example,  the  low  byte  of  the  X  coordinate  Is  stored  at  $047C  in 
the  original  and  UnlDisk  3.5  lie's,  while  it  is  stored  at  $047F  in  the 
memory  expansion  lie. 


Using  the  mouse  as  a  hand  controller 

You  can  use  the  mouse  as  if  it  were  a  set  of  hand  controllers  or  an  X- 
Y  pointing  device  in  port  4.  If  you  turn  the  mouse  on,  the  Monitor 
hand  controller  (game  paddle)  routines  take  input  from  the  mouse. 
This  is  possible  because  the  mouse  and  the  hand  controllers  all  use 
the  same  back  panel  connector. 

You  can  run  a  BASIC  program  that  uses  the  Pdl  function  to  read 
from  the  mouse  by  doing  the  following,  either  from  the  keyboard  or 
from  a  program: 

1 .  Start  up  the  system  with  the  BASIC  program  that  uses  paddles. 

2.  Type  PR#4  and  press  Return  to  tum  on  the  mouse. 

3.  Press  Control-A  Return  to  initialize  the  mouse. 

4.  Type  PR#0  and  press  Return  to  restore  output  to  the  screen. 

5.  Run  the  program. 

Play  the  game  using  the  mouse  instead  of  the  paddles. 


Important     Many  copy-protected  games  do  not  worl<  with  a  mouse.  In 
addition,  many  games  don't  use  built-in  firmware  for  the 
paddies, 


Game  input 

The  Apple  lie  supports  game  paddles,  joysticks,  and  other  hand 
controllers  connected  to  the  DB-9  connector  on  its  back  panel. 
Table  9-6  is  a  summary  of  game  input  characteristics. 
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Table  9-6 

Game  input  characteristics 


Port  number 

Commands 

Initial  charactsristics 


None. 
None. 
Game  inputs  cannot  be  disabled. 


Hardware  page  locations 

$C06l  Switch  input  0  and  Open  Apple. 

$C062  Switch  input  1  and  Solid  Apple. 

$C063  Mouse  button  (sense  is  opposite  that  of  $C06l  to 

distinguish  it  from  paddle  button). 

$C064  Analog  input  (paddle)  0. 

$C065  Analog  input  (paddle)  1. 

$C070  Trigger  paddle  timer. 

Monitor  firmware  routines 

Location        Name  Description 

$FB1E  PRead       Reads  a  paddle  position. 


I/O  firmware  entry  points 


Use  of  screen  holes 


None. 


None. 


Complete  electrical 
specifications  of  these  Inputs 
ore  given  In  Chapter  1 1  ; 
Table  11-22  shows  the 
connector  pin  numbers. 


The  hand  controller  connector  signals 

Several  iriputs  are  available  to  programs  or  devices  from  the  9-pin 
D-type  miniature  connector  on  the  back  of  the  Apple  IIc:  two  1-bit 
inputs,  or  switches,  and  two  analog  inputs. 

When  you  connect  a  pair  of  hand  controllers  to  the  9-pin 
connector,  the  rotary  controllers  use  two  analog  inputs,  and  the 
pushbuttons  use  two  1-bit  inputs.  However,  you  can  also  use  these 
inputs  for  many  other  jobs.  For  example,  two  analog  inputs  can  be 
used  with  a  two-axis  joystick. 


Game  input 
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Switch  inputs  (SwO  and  Swi ) 

The  two  1-bit  inputs  can  be  connected  to  the  output  of  another 
electronic  device  that  meets  the  electrical  requirements  described 
in  Chapter  11,  or  to  a  pushbutton.  When  you  read  a  byte  from  one 
of  these  locations,  only  the  high-order  bit — bit  7 — is  valid 
information;  the  rest  of  the  byte  is  undefined.  From  machine 
language,  you  can  do  a  Branch  Plus  or  Branch  Minus  on  the  state  of 
bit  7.  From  BASIC,  you  can  read  the  switch  with  a  PEEK  and 
compare  the  value  with  128.  If  the  value  is  128  or  greater,  the  switch 
is  on. 

The  memory  locations  for  these  switches  are  $C06l,  $C062,  and 
$C063  (decimal  locations  49249  through  49251),  as  shown  in 
Table  9-6.  Switch  0  and  switch  1  are  permanently  connected  to 
Open  Apple  and  Solid  Apple  on  the  keyboard;  these  are  the  ones 
connected  to  the  buttons  on  the  hand  controllers.  Location  $C063 
is  a  second  address  for  the  mouse  button,  so  that  a  program  can 
distinguish  it  from  an  Open  Apple  keypress.  When  die  mouse 
button  is  pressed,  $C063  (bit  7)  goes  from  1  to  0,  and  $C06l  (bit  7) 
goes  from  0  to  1. 

Analog  inputs  (PdlO  and  Pdl  1 ) 

The  two  analog  inputs  are  designed  for  lase  with  150-K£2  variable 
resistors  or  potentiometers.  The  variable  resistance  is  connected 
between  the  +5V  supply  and  each  input,  so  that  it  makes  up  part  of  a 
timing  circuit.  The  circuit  changes  state  when  its  time  constant  has 
elapsed,  and  the  time  constant  varies  as  the  resistance  varies.  Your 
program  can  measure  this  time  by  counting  in  a  loop  until  the 
circuit  changes  state,  or  times  out. 

A  program  must  first  reset  the  timing  circuits  before  it  can  read  the 
analog  inputs.  Accessing  memory  location  $C070  does  this.  As 
soon  as  you  reset  the  timing  circuits,  the  high  bits  of  the  bytes  at 
locations  $C064  through  $C067  are  set  to  1.  If  you  PEEK  at  them 
from  BASIC  Gocations  49252  through  49255),  the  values  will  be  128 
or  greater.  Within  about  three  milliseconds,  these  bits  will  change 
back  to  0 — ^byte  values  less  than  128 — ^and  remain  there  until  you 
reset  the  timing  circuits  again.  The  exact  amount  of  time  each  of  the 
bits  remains  high  is  directly  proportional  to  the  resistance 
connected  to  the  corresponding  input.  If  these  inputs  are  open — no 
resistances  are  connected — the  corresponding  bits  may  remain 
high  indefinitely. 
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Monitor  support  for  game  input 

To  read  the  analog  inputs  from  machine  language,  you  can  use  a 
program  loop  that  resets  the  timers  and  then  increments  a  counter 
until  the  bit  at  the  appropriate  memory  location  changes  to  0,  or 
you  can  use  the  built-in  routine  PRead.  BASIC  and  other  high-level 
languages  also  include  convenient  means  of  reading  the  analog 
inputs — refer  to  your  language  manuals.  You  can  read  and  reread 
the  same  paddle  at  arbitrarily  short  intervals.  However,  you  must 
wait  at  least  three  milliseconds  between  reading  one  paddle  and 
reading  a  different  paddle. 

The  Monitor  routine  PRead  (at  address  $FB1E)  places  in  the 
Y  register  a  number  between  $00  and  $FF  that  represents  the 
position  of  a  hand  controller.  You  pass  the  number  of  the  hand 
controller  in  the  X  register. 


Warning     If  the  hand  controller  number  you  furnish  in  the  X  register  does 
not  equal  0  or  1 ,  strange  things  may  happen. 

The  paddle  and  vertical  blanking  both  use  $C070.  Disable 
Interrupts  before  calling  PRead  if  you  are  reading  the  paddles 
and  using  VBL  Interrupts. 
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Using  the 
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The  System  Monitor  is  a  set  of  subroutines  in  the  Apple  He  firmware 
that  provides  a  standard  interface  to  the  built-in  I/O  devices 
described  in  Chapter  1.  Many  of  the  I/O  subroutines  described  in 
Chapters  3  through  9  are  part  of  the  System  Monitor. 

DOS  (but  not  ProDOS)  and  the  BASIC  interpreters  (Appendix  E) 
use  these  subroutines  by  direct  calls  to  their  starting  locations.  You 
can  call  the  standard  subroutines  from  your  programs  in  the  same 
fashion.  The  starting  addresses  for  all  of  the  standard  subroutines 
are  listed  in  Appendix  C. 

You  can  perform  most  of  the  Monitor  functions  directly  from  the 
keyboard.  This  chapter  tells  you  how  to  use  the  Monitor 

n  to  look  at  one  or  more  memory  locations 

D  to  change  the  contents  of  any  location 

n  to  write  small  programs  in  machine  language  to  be  executed 
directly  by  the  Apple  lie 

D  to  move  and  compare  blocks  of  memory 

n  to  invoke  other  programs  from  the  Monitor 


The  positive  and  negative 
decimal  equivalents  of  Monitor 
locations  are  listed  In 
Appendix  C.  In  addition. 
Appendix  H  contains  conversion 
tables  from  one  numbering 
system  to  another.  Appendix  E 
gives  further  details  on  how  to 
use  Apple  lie  firmware  from 
BASIC  programs. 


Invoking  the  Monitor 

The  System  Monitor  starts  at  memory  location  $FF69  (-151).  To 
invoke  the  Monitor,  you  make  a  CALL  -151  statement  to  this 
location  from  the  keyboard  or  from  a  BASIC  program.  When  the 
Monitor  is  rurming,  its  prompting  character,  an  asterisk  (*), 
appears  on  the  left  side  of  the  display  screen,  followed  by  a  cursor. 

To  use  the  Monitor,  you  type  commands  at  the  keyboard.  When  you 
have  finished  using  the  Monitor,  you  return  to  the  BASIC  language 
you  were  previously  using  by  pressing  Control-Reset,  by  pressing 
Control-C  and  then  Return,  or  by  typing  3D0G,  which  executes  the 
resident  program — ^usually  Applesoft — whose  address  is  stored  in  a 
jump  instruction  at  location  $03D0. 


Important     If  ProDOS  (or  DOS)  Is  connected  via  ttie  standard  I/O  links 
(Chapter  3),  ttien  you  can  Issue  commands  to  It  from  thie 
Monitor.  Under  thiis  arrangement,  errors  will  return  control  to 
BASIC  rather  than  to  the  Monitor. 

If  you  want  to  have  Control-Reset  return  you  to  the  Moiutor,  load 
the  values  $69,  $FF,  and  $5A  (decimal  105,  255,  and  90)  into  the 
three  locations  starting  at  address  $03F2  (decimal  1010,  the  reset- 
vector  address  and  the  power-up  byte). 
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Syntax  of  Monitor  commands 

To  give  a  command  to  the  Monitor,  you  type  a  line  on  the 
keyboard,  theh  press  Return.  The  Monitor  accepts  the  line  using  the 
standard  I/O  subroutine  GetLn  described  in  Chapter  3.  A  Monitor 
command  can  be  up  to  255  characters  in  length,  ending  with  a 
carriage  return.  It  can  include  three  kinds  of  information: 
addresses,  data  values,  and  command  characters.  You  type 
addresses  and  data  values  in  hexadecimal  notation. 

When  the  command  you  type  calls  for  an  address,  the  Monitor 
accepts  any  group  of  hexadecimal  digits.  If  there  are  fewer  than  four 
digits  in  the  group,  it  adds  leading  O's;  if  there  are  more  than  four 
hexadecimal  digits,  the  Monitor  uses  only  the  last  four  digits.  It 
follows  a  similar  procedure  when  the  command  syntax  calls  for  two- 
digit  data  values. 

Each  command  you  type  consists  of  one  command  character, 
usually  the  first  letter  of  the  command  name.  The  Monitor 
recognizes  22  different  command  characters.  Some  of  them  are 
punctuation  marks,  some  are  letters  (uppercase  or  lowercase),  and 
some  are  control  characters. 

♦  Note:  Although  the  Monitor  recognizes  and  interprets  them, 
control  characters  typed  on  an  input  line  do  not  appear  on  the 
screen. 

This  chapter  contains  examples  of  Monitor  command  use.  Some  of 
the  data  values  displayed  by  your  Apple  lie  may  differ  from  the 
values  printed  in  these  examples,  because  they  are  variables  stored 
in  RAM. 


Monitor  memory  commands 

when  you  use  the  Monitor  to  examine  and  change  the  contents  of 
memory,  it  keeps  track  of  the  address  of  the  last  location  whose 
value  you  inquired  about  and  the  address  of  the  location  that  is  next 
to  have  its  value  changed.  These  are  called  the  last  opened  location 
and  the  next  changeable  location. 


Warning      Because  locations  $C000  through  $COFF  contain  special 

hardware  circuits.  Issuing  any  command  that  reads  or  writes  on 
this  page  can  have  unpredictable,  and  perhaps  disastrous, 
results. 
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Examining  memory  contents 

when  you  type  the  address  of  a  memory  location  and  press  Return, 
the  Monitor  responds  with  the  address  you  typed,  a  dash,  a  space, 
and  the  value  stored  at  that  location,  like  this: 

*E000 
EOOO-  4C 
*33 
0033-  AA 


Each  time  the  Monitor  displays  the  value  stored  at  a  location,  it 
saves  that  address  as  the  last  opened  location  and  as  the  next 
changeable  location. 


Memory  dump 

When  you  type  a  period  C)  followed  by  an  address,  and  then  press 
Return,  the  Monitor  displays  a  memory  dump:  the  data  values 
stored  at  all  the  memory  locations  from  the  one  following  the  last 
opened  location  to  the  location  whose  address  you  typed  following 
the  period.  The  Monitor  saves  the  last  location  displayed  as  both 
the  last  opened  location  and  the  next  changeable  location.  In  these 
examples,  the  amount  of  data  displayed  by  the  Monitor  depends  on 
how  much  larger  the  address  after  the  period  is  than  the  last  opened 
location. 


*20 

0020- 

00 

*.2B 

0021- 

28 

00 

18 

OF 

oc 

00 

00 

0028- 

A8 

06 

DO 

07 

*300 

0300- 

99 

*.315 

0301- 

B9 

00 

08 

OA 

OA 

OA 

99 

0308- 

00 

08 

C8 

DO 

F4 

A6 

2B 

A9 

0310- 

09 

85 

27 

AD 

CO 

03 

*.32A 

0316- 

85 

41 

0318- 

84 

40 

8A 

4A 

4A 

4A 

4A 

09 

0320- 

CO 

85 

3F 

A9 

5D 

85 

3E 

20 

0328- 

43 

03 

20 

* 
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When  the  Monitor  performs  a  memory  dump,  it  starts  at  the 
address  immediately  following  the  last  opened  location  and 
displays  that  address  and  the  data  value  stored  there.  It  then 
displays  the  values  of  successive  locations  up  to  and  including  the 
location  whose  address  you  typed,  but  only  up  to  eight  values  on  a 
line.  When  it  reaches  a  location  whose  address  is  a  multiple  of 
8 — that  is,  one  that  ends  with  an  8  or  a  0 — ^it  displays  that  address  as 
the  beginning  of  a  new  line,  then  continues  displaying  more  values. 

After  the  Monitor  has  displayed  the  value  at  the  location  whose 
address  you  specified  in  the  command,  it  stops  the  memory  dump 
and  sets  that  location  as  both  the  last  opened  location  and  the  next 
changeable  location.  If  the  address  specified  on  the  input  line  is  less 
than  the  address  of  the  last  opened  location,  the  Monitor  displays 
only  the  address  and  value  of  the  location  following  the  last  opened 
location. 

You  can  combine  the  two  commands,  opening  a  location  and 
dumping  memory,  by  concatenating  them:  type  the  first  address,  a 
period,  and  the  second  address.  This  combination  of  two  addresses 
separated  by  a  period  is  called  a  memory  range. 

*300.32F 

03CiO-  99  B9  00  08  OA  OA  OA  99 

0308-  00  08  08  DO  F4  A6  2B  A9 

0310-  09  85  27  AD  CO  03  85  41 

0318-  84  40  8A  4A  4A  4A  4A  09 

0320-  CO  85  3F  A9  5D  85  3E  20 

0328-  43  03  20  46  03  A5  3D  4D 

*30.40 

0030-  AA  00  FF  AA  05  02  05  C2 

0038-  IB  FD  DO  03  30  00  40  00 

0040-  30 

*E015.E025 

E015-  40  ED  FD 

E018-  A9  20  05  24  BO  00  A9  8D 

E020-  AO  07  20  ED  FD  A9 
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Pressing  Return  by  itself  makes  the  Monitor  display  one  line  of  a 
memory  dump;  that  is,  a  memory  dump  from  the  location 
following  the  last  opened  location  to  the  next  multiple-of-eight 
boundary.  The  Monitor  saves  the  address  of  the  last  location 
displayed  as  both  the  last  opened  location  and  the  next  changeable 
location. 

*5 

0005-    00 
♦Return 
00   00 
♦Return 

0008-    00    00    00    00    00    00    00    00 

*32 

0032-    FF 

♦Return 

AA    00    C2    05    02 

♦Return 

0038-  IB  FD  DO  03  3C  00  3F  00 


Changing  memory  contents 

The  section  on  memory  dumping  showed  you  how  to  display  values 
stored  in  the  Apple  He's  memory;  this  section  shows  you  how  to 
change  these  values.  You  can  change  any  location  in  RAM;  you  can 
change  the  characteristics  and  treatment  of  an  output  device  by 
changing  the  contents  of  locations  assigned  to  it;  and  you  can 
change  a  soft  switch  setting  by  referencing  its  set  and  reset 
addresses. 


Warning     Use  these  commands  carefully.  If  you  change  the  zero-page 
locations  used  by  the  Interpreter  or  operating  system 
(Appendix  B),  you  may  lose  programs  or  data  stored  in  memory. 


Changing  one  byte 

The  previous  commands  keep  track  of  the  next  changeable 
location;  these  commands  make  use  of  it  In  the  next  example,  you 
open  location  0,  then  type  a  colon  followed  by  a  value. 

♦0 

0000-   40 
♦:5F 
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The  contents  of  the  next  changeable  location  have  just  been 
changed  to  the  value  you  typed,  as  you  can  see  by  examining  that 
location: 


*o 

0000-   5F 


You  can  also  combine  opening  and  changing  into  one  operation  by 
typing  an  address  followed  by  a  colon  and  a  value.  In  the  next 
example,  you  type  the  address  again  to  verify  the  change. 

*302:42 
*302 
0302-    42 

* 

When  you  change  the  contents  of  a  location,  the  value  that  was 
contained  in  that  location  is  replaced  by  the  new  value,  which  will 
remain  until  you  or  some  program  replaces  it  with  another  value. 

♦  ASCII  input  mode:  The  Monitor  has  a  tool  to  make  entering 
values  a  little  easier:  ASCII  input  mode.  ASCII  input  mode  lets 
you  enter  ASCII  characters  as  well  as  their  hexadecimal  ASCII 
equivalents.  This  means  that  'A  is  the  same  as  CI  and  B  is  the 
same  as  C2  to  the  Monitor.  The  ASCII  value  for  any  character 
following  an  apostrophe  is  used  by  the  Monitor.  For  example, 
to  enter  the  string  "Good  morning!"  at  $0300  in  memory,  type 

*300:'G  'o    'o    'd    ■    'm    "o    'r    'n    'i    'n    'g    ■! 

Note  that  each  character  to  be  placed  in  memory  is  delimited 
by  a  leading  and  a  trailing  space.  The  only  exception  to  this  rule 
is  that  the  last  character  in  the  line  is  followed  by  a  return 
character  instead  of  a  space. 

Changing  consecutive  locations 

You  don't  have  to  type  a  separate  command  with  an  address,  a 
colon,  a  value,  and  press  Return  for  each  location  you  want  to 
change.  You  can  change  the  values  of  up  to  85  consecutive  locations 
at  a  time — or  even  more,  if  you  omit  leading  O's  from  the 
values — ^by  typing  only  the  initial  address  and  colon  followed  by  all 
the  values  separated  by  spaces;  end  with  Return.  The  Monitor  stores 
the  consecutive  values  in  consecutive  locations,  starting  at  the 
location  whose  address  you  typed.  After  it  has  processed  the  string 
of  values,  it  takes  the  location  following  the  last  changed  location  as 
the  next  changeable  location.  Thus,  you  can  continue  changing 
consecutive  locations,  without  typing  an  address  on  the  next  input 
line,  by  typing  another  colon  and  more  values. 
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In  these  examples,  you  first  change  some  locations,  then  examine 
them  to  verily  the  changes. 


♦300:69   01    20   ED   FD   4C   03 

*300 

0300-    69 

•Return 

01   20   ED  FD   4C   00   03 

*10:0    12   3 

*:4   5    6   7 

*10.17 

0010-   00   01    02    03   04    05    06   07 


Moving  data  in  memory 

You  can  copy  a  contiguous  block  of  data  from  one  area  in  the 
Apple  He's  memory  to  another  in  RAM  by  using  the  Monitor's 
MOVE  command.  To  move  a  range  of  memory,  you  must  tell  the 
Monitor  both  where  the  data  is  now  situated  in  memory — the  source 
locations — and  where  you  want  the  copy  to  go — the  destination 
locations. 

The  format  of  the  complete  MOVE  command  looks  like  this: 

[destination]  <  {starit .  (endi  M 

The  destination  is  the  address  where  you  want  the  first  of  the  moved 
data  to  go.  The  less-than  symbol  (<)  separates  the  destination 
address  from  the  starting  and  ending  addresses  of  the  block  of  data 
to  be  moved.  The  period  between  two  addresses  is  the  Monitor's 
standard  notation  for  specifying  address  ranges.  If  the  second 
address  in  the  source  range  specification  is  less  than  the  first,  then 
only  one  value  (that  of  the  first  location  in  the  range)  will  be  moved. 

When  you  type  the  actual  command,  replace  the  words  in  braces 
with  hexadecimal  addresses,  and  omit  the  braces  and  spaces. 
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See  'Advanced  Operations'  for 
an  Interesting  application  of  this 
feature. 


Here  are  some  examples  of  memory  moves.  First,  you  examine  the 
values  stored  in  one  range  of  memory,  then  store  several  values  in 
another  range  of  memory.  The  actual  MOVE  commands  end 
with  M. 

*0.F 

0000-  5F  00  05  07  00  00  00  00 

0008-  00  00  00  00  00  00  00  00 

*300:A9  8D  20  ED  FD  A9  45  20  DA  FD  40  00  03 

*300.30C 

0300-  A9  8D  20  ED  FD  A9  45  20 

0308-  DA  FD  40  00  03 

*0<300.30C  M 

*0.C 

0000-  A9  8D  20  ED  FD  A9  45  20 

0008-  DA  FD  40  00  03 

*310<8.A  M 

*310.312 

0310-  DA  FD  40 

*2<7.9  M 

*0.C 

0000-  A9  8D  20  DA  FD  A9  45  20 

0008-  DA  FD  40  00  03 

* 

The  Monitor  moves  a  copy  of  the  data  stored  in  the  source  range  of 
locations  to  the  destination  locations.  The  values  in  the  source 
range  are  left  undisturbed.  The  Monitor  remembers  the  last 
location  in  the  source  range  as  the  last  opened  location,  and  the 
first  location  in  the  source  range  as  the  next  changeable  location. 

If  the  destination  address  of  the  MOVE  command  is  inside  the 
source  range  of  addresses,  then  strange  things  happen:  the 
locations  between  the  beginning  of  the  source  range  and  the 
destination  address  are  treated  as  a  subrange  and  the  values  in  this 
subrange  are  replicated  throughout  the  source  range.  Try  it. 


Comparing  data  in  memory 

You  can  use  the  VERIFY  command  to  compare  two  ranges  of 
memory  using  the  same  format  you  use  to  move  a  range  of  memory 
from  one  place  to  another.  In  fact,  the  VERIFY  command  can  be 
used  immediately  after  a  MOVE  to  make  sure  that  the  move  was 
successful. 

The  VERIFY  command,  like  the  MOVE  command,  needs  a  range 
and  a  destination.  The  syntax  of  the  VERIFY  command  is 


{destination}  <  [starii .  (ends  V 
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The  Monitor  compares  the  values  in  the  source  locations  with  the 
values  in  the  locations  beginning  at  the  destination  address.  If  any 
values  don't  match,  the  Monitor  displays  the  address  at  which  the 
discrepancy  was  found  and  the  two  values  that  differ.  In  the 
example,  you  store  data  values  in  the  range  of  locations  from 
0  to  $0D,  copy  them  to  locations  starting  at  $0300  with  the  MOVE 
command,  and  then  compare  them  using  the  VERIFY  command. 
When  you  use  the  VERIFY  command  after  you  change  the  value  at 
location  6  to  $E4,  it  detects  the  change. 

*0:D7  F2  E9  F4  F4  E5  EE  AO  E2  F9  AO  C3  04  C5 

*300<0.D  M 

*300<0.D  V 

*6:E4 

*300<O.D  V 

0006-E4  (EE) 

* 

If  the  VERIFY  command  finds  a  discrepancy,  it  displays  the  address 
of  the  location  in  the  source  range  whose  value  differs  from  its 
counterpart  in  the  destination  range.  If  there  is  no  discrepancy, 
VERIFY  displays  nothing.  The  VERIFY  command  leaves  the  values 
in  both  ranges  unchanged.  The  last  opened  location  is  the  last 
location  in  the  source  range,  and  the  next  changeable  location  is 
the  first  location  in  the  source  range,  just  as  in  the  MOVE 
command.  If  the  ending  address  of  the  range  is  less  than  the  starting 
address,  the  values  of  only  the  first  locations  in  the  ranges  are 
compared.  Like  the  MOVE  command,  the  VERIFY  command  does 
unusual  things  if  the  destination  address  is  within  the  source  range; 
see  "Advanced  Operations"  later  in  this  chapter. 


Monitor  register  commands 

Even  though  the  actual  contents  of  the  65C02's  internal  registers  are 
changing  as  you  use  the  Monitor,  you  can  examine  the  values  that 
the  registers  contained  at  the  time  the  Monitor  gained  control, 
either  because  you  called  it  or  because  the  program  you  are 
debugging  stopped  at  a  break  (BRK).  You  can  also  store  new 
register  values  that  will  be  used  when  you  execute  a  program  from 
the  Monitor  using  the  GO  command,  described  below. 
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Changing  registers 

When  you  call  the  Monitor,  it  stores  the  contents  of  the  65C02 
registers  in  memory.  The  registers  are  stored  in  the  order  A,  X,  Y, 
P  (processor  status  register),  and  S  (stack  pointer),  starting  at 
location  $45.  When  you  give  the  Monitor  a  GO  command,  the 
Monitor  loads  the  registers  from  these  five  locations  before  it 
executes  the  first  instruction  in  your  program. 


Examining  registers 

Pressing  Control-E  and  then  Return  invokes  the  Monitor's 
EXAMINE  command,  which  displays  the  stored  register  values  and 
sets  the  location  containing  the  contents  of  the  A  register  as  the  next 
changeable  location.  After  using  the  EXAMINE  command,  you  can 
change  the  values  in  these  locations  by  typing  a  colon  and  then 
typing  the  new  values  separated  by  spaces.  In  the  following 
example,  you  display  the  registers,  change  the  first  two,  and  then 
display  them  again  to  verify  the  change. 

*  Control-E 

M=00   A=OA  X=FF   Y=D8   P=BO   S=F8 

*:B0    02 

*Control-E 

M=00   A=BO   X=02   Y=D8   P=BO   S=F8 

* 

In  the  EXAMINE  command's  display,  M  shows  the  current  memory 
state  register  contents.  The  memory  state  register  is  location  $44, 
and  its  interpretation  is  given  in  Appendix  E. 


Miscellaneous  Monitor  commands 

Monitor  commands  discussed  in  this  section  let  you  do  the 
following: 

D  change  the  video  display  format  from  normal  to  inverse  and 
back 

n  assign  input  and  output  to  various  devices 

n  leave  the  Monitor  and  return  to  the  currently  loaded  operating 
system  (DOS  3.3  or  ProDOS)  or  BASIC 
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The  COut  subroutine  Is 
described  In  Chapter  3. 


Display  inverse  and  normal 

You  can  control  the  setting  of  the  inverse-nonnal  mask  location 
used  by  the  COut  subroutine  from  the  Monitor  so  that  all  the 
Monitor's  output  will  be  in  inverse  format.  The  INVERSE 
command  OD  sets  the  mask  so  that  all  subsequent  inputs  and  outputs 
are  displayed  in  inverse  format  To  switch  the  Monitor's  output  back 
to  normal  format,  use  the  NORMAL  command  (N). 

*0.F 

0000-  OA  OB  OC  OD  OE  OF  DO  04 

0008-  06  01  FO  08  CA  DO  F6  A6 

*I 

*0.F 

0000- 

0008- 

*N 

*0.F 

0000-  OA  OB  OC  OD  OE  OF  DO  04 

0008-  C6  01  FO  08  CA  DO  F6  A6 


OA  OB  OC  OD  OE  OF  DO  04 
C6  01  FO  08  CA  DO  F6  A6 


See  Appendix  D. 


Back  to  BASIC 

If  you  are  using  one  of  the  Apple  disk  operating  systems  (ProDOS  or 
DOS),  press  Control-Reset  or  type  3D0G  to  return  to  the  language 
you  were  vising,  with  your  program  and  variables  intact. 


Important     If  you  type  3D0G,  make  sure  ttiat  the  third  character  you  type 
is  a  zero,  not  a  ietter  O.  The  ietter  G  is  the  Monitor's  GO 
connmand. 

If  there  is  no  operating  system  in  RAM,  use  the  BASIC  command 
Control-B  to  leave  the  Monitor  and  enter  the  BASIC  interpreter  that 
was  active  when  you  entered  the  Monitor.  (Normally  this  is 
Applesoft  BASIC.)  Any  program  or  variables  that  you  previously 
had  in  BASIC  will  be  lost  If  you  want  to  reenter  BASIC  with  your 
previous  program  and  variables  intact,  use  the  CONTINUE  BASIC 
command  (Control-C). 
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Chapter  3  lists  the  Apple  He  port 
numbers  available. 


For  more  Information  on  the 
way  those  commands  work, 
refer  to  "The  Standard  I/O 
Links'  In  Chapters. 


Redirecting  Input  and  output 

The  Contxol-P  command  diverts  all  output  normally  destined  for 
the  screen  (port  0)  to  a  device  attached  to  one  of  the  other  ports, 
from  1  to  7.  The  format  of  the  command  is 

{port  number^  Control-P 

A  Control-P  command  to  port  number  0  switches  the  stream  of 
output  characters  back  to  the  Apple  He's  video  display.  However, 
use  Escape  Control-Q  if  the  enhanced  video  firmware  is  active 
(solid-block  cursor). 

Control-K  controls  the  input  stream  in  much  the  same  way  that 
Control-P  controls  the  output  stream.  The  format  for  the  command 
is 

{port  number^  Control-K 

Pressing  O  Control-K  directs  the  Monitor  to  accept  input  from  the 
Apple  He's  built-in  keyboard. 

The  Control-P  and  Control-K  commands  are  the  exact  equivalents 
of  the  BASIC  (but  not  DOS  and  ProDOS)  commands  PR#  and  EST*. 


Hexadecimal  arithmetic 

You  can  use  the  Monitor  as  a  one-byte  hexadecimal  addition  and 
subtraction  calculator.  Just  type  a  line  in  one  of  these  formats 
followed  by  Return: 

{valu^  +  {valu^  Return  {valuei  -  {valuei  Retum 

The  Apple  lie  performs  the  arithmetic  and  displays  the  result,  as 
shown  in  these  examples. 

*20+13 

=33 

*4A-C 

=3E 
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Advanced  operations 

This  section  describes  some  ways  of  using  the  Monitor  commands 
to  speed  up  your  work. 


Multiple-command  lines 

You  can  put  as  many  Monitor  commands  on  a  single  line  as  you 
like,  as  long  as  you  separate  them  with  spaces,  and  the  total  number 
of  characters  in  the  line  is  less  than  254.  Adjacent  single-letter 
commands  such  as  L,  S,  I,  and  N  need  not  be  separated  by  spaces. 

You  can  freely  intermix  all  of  the  commands  except  the  STORE  G) 
command.  Because  the  Monitor  takes  all  values  following  a  colon 
and  places  them  in  consecutive  memory  locations,  the  last  value  in 
a  STORE  must  be  followed  by  a  letter  command  before  another 
address  is  encountered.  You  can  use  the  NORMAL  command  as  the 
required  letter  command  in  such  cases;  it  usually  has  no  effect  and 
can  be  used  anywhere. 

In  the  following  example,  you  display  a  range  of  memory,  change 
it,  and  display  it  again,  all  with  one  line  of  commands. 

*300.307  300:18  69  IN  300.302 
0300-  00  00  00  00  00  00  00  00 
0300-  18  69  01 

* 

If  the  Monitor  encounters  a  character  in  the  input  line  that  it  does 
not  recognize  as  either  a  hexadecimal  digit  or  a  valid  command 
character,  it  executes  all  the  commands  on  the  input  line  up  to  that 
character,  then  stops  with  a  beep  and  ignores  the  remainder  of  the 
input  line. 


Filling  memory 

The  MOVE  command  can  be  used  to  replicate  a  pattern  of  values 
throughout  a  range  of  memory.  To  do  this,  first  store  the  pattern  in 
the  first  locations  in  the  range 

*300:11   22   33 
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Remember  the  number  of  values  in  the  pattern:  in  this  case,  it 
is  three.  Use  the  number  to  compute  addresses  for  the  MOVE 
command,  like  this: 

[start+numbet]  <  [starH  .  [end-number)  M 

This  MOVE  command  first  replicates  the  pattern  at  the  locations 
immediately  following  the  original  pattern,  then  replicates  that 
pattern  following  itself,  and  so  on  until  it  fills  the  entire  range. 

*303<300.32DM 

*300".32F 

0300-  11  22  33  11  22  33  11  22 

0308-  33  11  22  33  11  22  33  11 

0310-  22  33  11  22  33  11  22  33 

0318-  11  22  33  11  22  33  11  22 

0320-  33  11  22  33  11  22  33  11 

0328-  22  33  11  22  33  11  22  33 

* 

You  can  use  the  VERIFY  command  to  check  whether  a  pattern 
repeats  itself  through  memory.  This  is  especially  useful  to  verify  that 
a  given  range  of  memory  locations  all  contain  the  same  value.  In 
this  example,  to  see  the  VERIFY  command  detect  the  discrepancy, 
you  first  fill  the  memory  range  from  $0300  to  $0320  with  O's  and 
verify  it,  then  change  one  location  and  verify  again: 

*300:0 

*301<300.31FM 
*301<300.31F  V 
*304:02 

*301<300.31F  V 
0303-00  (02) 
0304-02  (00) 


Repeating  commands 

You  can  create  a  command  line  that  repeats  one  or  more 
commands  over  and  over.  You  do  this  by  beginning  the  part  of  the 
command  line  that  you  want  to  repeat  with  a  letter  command,  such 
as  N,  and  ending  it  with  the  sequence  34:n,  where  n  is  a 
hexadecimal  number  that  specifies  the  position  in  the  line  of  the 
command  where  you  want  to  start  repeating;  for  the  first  character 
in  the  line,  n=0.  The  value  for  n  must  be  followed  with  a  space  in 
order  for  the  loop  to  work  properly. 
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This  trick  takes  advantage  of  the  fact  that  the  Monitor  uses  an  index 
register  to  step  through  the  input  buffer,  starting  at  location  $0200. 
Each  time  the  Monitor  executes  a  command,  it  stores  the  value  of 
the  index  at  location  $34;  when  that  command  is  finished,  the 
Monitor  reloads  the  index  register  with  the  value  at  location  $34.  By 
making  the  last  command  change  the  value  at  location  $34,  you 
change  this  index  so  that  the  Monitor  picks  up  the  next  command 
character  from  an  earlier  point  in  the  buffer. 

The  only  way  to  stop  a  loop  like  this  is  to  press  Control-Reset;  that  is 
how  this  example  ends. 

*N  300  302  34:0  N 

0300-  11 

0302-  33 

0300-  11 

0302-  33 

0300-  11 

0302-  33 

0300-  11 

0302-  33 

0300-  11 

0302-  33 

0300-  11 

0302-  33 

030 


Creating  your  own  commands 

The  USER  command  (Control-Y)  forces  the  Monitor  to  jump  to 
memory  location  $03F8.  You  can  put  a  JMP  instruction  there  that 
jumps  to  your  own  machine-language  program.  Your  program  can 
then  examine  the  Monitor's  registers  and  pointers  or  the  input 
buffer  itself  to  obtain  its  data.  For  example,  here  is  a  program  that 
displays  everything  on  the  input  line  after  the  Control-Y.  The 
program  starts  at  location  $0300;  the  command  line  that  starts  with 
$03F8  stores  a  jump  to  $0300  at  location  $03F8. 

*300:A4  34  B9  00  02  20  ED  FD  C8  C9  8D  DO  F5  4C  69  FF 

*3F8:4C  00  03 

*Control-Y  THIS   IS  A  TEST 

THIS    IS   A   TEST 
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Machine-language  programs 

The  main  reason  to  program  in  machine  language  is  to  get  more 
speed  and  sometimes  to  also  save  memory  space.  A  program  in 
machine  language  can  run  much  faster  than  the  same  program 
written  in  high-level  languages  such  as  BASIC  or  Pascal,  but  the 
machine-language  version  usually  takes  a  lot  longer  to  write.  There 
are  other  reasons  to  use  machine  language:  you  might  want  your 
program  to  do  something  that  isn't  included  in  your  high-level 
language,  or  you  might  just  enjoy  the  challenge  of  using  machine 
language  to  work  directly  on  the  bits  and  bytes. 

♦  Note:  If  you  have  never  used  machine  language  before,  you'll 
need  to  learn  the  65C02  instructions  listed  in  Appendix  A.  To 
become  proficient  at  programming  in  machine  language, 
you'll  have  to  spend  some  time  at  it,  and  study  one  of  the  books 
on  65C02  programming  listed  in  the  bibliography. 

You  can  get  a  hexadecimal  dump  of  your  program  or  move  it 
around  in  memory  using  the  commands  described  in  the  previous 
sections.  The  Monitor  commands  in  this  section  are  intended 
specifically  for  you  to  use  in  creating,  writing,  and  debugging 
machine-language  programs. 


Running  a  program 

The  Monitor  command  to  start  execution  of  your  machine- 
language  program  is  the  GO  command.  When  you  type  an  address 
and  press  G,  the  Apple  lie  starts  executing  machine-language 
instructions  starting  at  the  specified  location.  If  you  just  press  G, 
execution  starts  at  the  last  opened  location.  The  Monitor  treats  this 
program  as  a  subroutine:  it  should  end  with  an  RTS  (return  from 
subroutine)  instruction  to  transfer  control  back  to  the  Monitor. 

The  Monitor  has  some  special  features  that  make  it  easier  for  you  to 
write  and  debug  machine-language  programs,  but  before  you  get 
into  that,  here  is  a  small  machine-language  program  that  you  can 
run  using  only  the  simple  Monitor  commands  already  described. 
The  program  in  the  example  merely  displays  the  letters  A 
through  Z:  you  store  it  starting  at  location  $0300,  examine  it  to  be 
sure  you  typed  it  correctly,  then  type  3D0G  to  start  it  running. 

*300:A9  CI  20  ED  FD  18  69  1  C9  DB  DO  F6  60 

*300.30C 

0300-  A9  CI  20  ED  FD  18  69  01 

0308-  C9  DB  DO  F6  60 

*300  G 

ABCDEFGHIJKLMNOPQRSTUVWXYZ 

* 
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Disassembled  programs 

Machine-language  code  in  hexadecimal  isn't  the  easiest  thing  in  the 
world  to  read  and  understand.  To  make  this  job  a  little  easier, 
machine-language  programs  are  usually  written  in  assembly 
language  and  converted  into  machine-language  code  by  programs 
called  assemblers. 

Programs  like  the  Monitor's  LIST  command  are  called 
disassemblers.  This  command  displays  machine-language  code 
in  assembly-language  form.  Instead  of  unformatted  hexadecimal 
gibberish,  the  LIST  command  displays  each  instruction  on  a 
separate  line,  with  a  three-letter  instruction  name,  or  mnemonic, 
and  a  formatted  hexadecimal  operand.  The  LIST  command  also 
converts  the  relative  addresses  used  in  branch  instructions  to 
absolute  addresses. 

The  Monitor  LIST  command  has  the  format 
{location^  L 

The  LIST  command  starts  at  the  specified  location  and  displays  as 
much  memory  as  it  takes  to  make  up  a  screenful  (20  lines)  of 
instructions,  as  shown  in  the  following  example: 


*300  L 

0300- 

A9 

01 

LDA 

#$C1 

0302- 

20 

ED  FD 

JSR 

$FDED 

0305- 

18 

CLC 

0306- 

69 

01 

ADC 

#$01 

0308- 

09 

DB 

CMP 

#$DB 

030A- 

DO 

F6 

BNE 

$0302 

030C- 

60 

RTS 

030D- 

00 

BRK 

030E- 

00 

BRK 

030F- 

00 

BRK 

0310- 

00 

BRK 

0311- 

00 

BRK 

0312- 

00 

BRK 

0313- 

00 

BRK 

0314- 

00 

BRK 

0315- 

00 

BRK/ 

0316- 

00 

BRK 

0317- 

00 

BRK 

0318- 

00 

BRK 

0319- 

00 

BRK 
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The  first  seven  lines  of  this  example  are  the  assembly-language  form 
of  the  program  you  typed  in  the  previous  example.  The  rest  of  the 
lines  are  BRK  instructions  only  if  this  part  of  memory  has  O's  in  it: 
other  values  will  be  disassembled  as  other  instructions. 

The  Monitor  saves  the  address  that  you  specify  in  the  LIST 
command,  but  not  as  the  last  opened  location  used  by  the  other 
commands.  Instead,  the  Monitor  saves  this  address  as  the  program 
counter,  which  it  uses  only  to  point  to  locations  within  programs. 
Whenever  the  Monitor  performs  a  LIST  command,  it  sets  the 
program  counter  to  point  to  the  location  immediately  following  the 
last  location  displayed  on  the  screen,  so  that  if  you  type  another 
LIST  command  it  displays  another  screenful  of  instructions,  starting 
where  the  previous  display  left  off. 


The  STEP  and  TRACE  commands 


Important     This  section  applies  only  to  ttie  UniDlsk  3.5  and  memory 
expansion  versions  of  ttie  Apple  lie. 

STEP  and  TRACE  are  Monitor  facilities  for  debugging  assembly- 
language  programs.  The  STEP  command  decodes,  displays,  and 
executes  one  instruction  at  a  time,  and  the  TRACE  command  steps 
continuously  through  a  program,  stopping  when  a  BRK  instruction 
is  executed  or  Solid  Apple  is  pressed.  You  can  press  Open  Apple  to 
slow  down  the  trace  to  one  step  per  second. 

Each  STEP  command  causes  the  Monitor  to  execute  the  instruction 
in  memory  pointed  to  by  the  program  counter.  The  instruction  is 
displayed  in  its  disassembled  form,  then  executed.  The  contents  of 
the  65C02's  internal  registers  are  displayed  after  the  instruction  is 
executed.  After  execution,  the  program  counter  is  incremented  to 
point  to  the  next  instruction  in  the  program. 

Here  is  an  example  of  the  STEP  command,  using  the  following 
program: 


$0300: 

LDX 

#02 

$0302: 

LDA 

$00, X 

$0304: 

STA 

$10, X 

$0306: 

DEX 

$0307: 

STA 

$C030 

$030A: 

BPL 

$0302 

$0300: 

BRK 
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To  step  through  this  program,  first  call  the  Monitor  by  typing 
CALL  -151  and  pressing  Return,  and  then  fi-om  the  Monitor  type 
30 OS  (to  start  the  STEP  routine  at  address  $0300).  Type  S  to 
advance  each  additional  step  through  the  program.  The  Monitor 
keeps  the  program  counter  and  the  last  opened  address  separate 
from  one  another,  so  you  can  examine  or  change  the  contents  of 
memory  while  you  are  stepping  through  your  program.  Here's  what 
happens  when  you  step  through  the  program  above,  examining  the 
contents  of  location  $0012  after  the  third  step.  Note  that  in  this 
example,  what  you  type  appears  just  after  the  *  prompt,  and  the 
information  on  the  next  two  lines — ^that  begin  without  the  * 
prompt — is  what  the  computer  displays  on  the  screen  in  response. 

*300S 

0300-    A2  02     LDX  #02 

M=CA  A=OA  X=02  Y-DS  P=30  S=F8 

*S 

0302-    B5  00     LDA  $00, X 

M=CA  A=0C  X=02  Y=D8  P=30  S=F8 

*S 

0304-    95  10     STA  $10, X 

M=CA  A=OC  X=02  Y=D8  P=30  S=F8 

*12 

0012-  OC 

*S 

0306-  CA        DEX 

M=CA  A=0C  X=01  Y=D8  P=30  S=F8 
*S 

0307-  8D  30  CO  STA  $C030 
M=CA  A=OC  X=01  Y=D8  P=30  S=F8 
*S 

030A-    10  F6    BPL  $0302 

M=CA  A=OC  X=01  Y=D8  P=30  S=F8 

*S 

0302-    B5  00     LDA  $00,  X 

M=CA  A=0B  X=01  Y=D8  P=30  S=F8 

*S 

0304-    95  10     STA  $10, X 

M=CA  A=0B  X=01  Y=D8  P=30  S=F8 

* 

The  TRACE  command  is  a  continuous  version  of  the  STEP 
command;  it  stops  stepping  through  the  program  only  when  you 
press  Solid  Apple,  or  when  it  encounters  a  BRK  instruction  in  the 
program.  Press  Open  Apple  to  slow  the  trace  to  one  step  per 
second. 
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Important     Keep  the  following  cautions  in  mind  wtien  using  ttie  STEP  and 
TRACE  Monitor  commands: 

D  If  thie  program  ends  with  an  RTS  Instruction,  ttie  TRACE 
routine  will  continue  to  run  Indefinitely  until  stopped  witti 
Solid  Apple. 

n  You  can't  step  or  trace  through)  routines  that  use  the  some 
zero  page  locations  as  the  IVIonltor. 


The  Mini-Assembler 


Important 


This  section  applies  only  to  the  UnlDisk  3.5  and  memory 
expansion  versions  of  the  Apple  lie. 


Without  an  assembler,  you  have  to  write  your  machine-language 
program,  take  the  hexadecimal  values  for  the  opcodes  and 
operands,  and  store  them  in  memory  using  the  Monitor  commands 
described  earlier  in  this  chapter. 

The  Mini-Assembler  lets  you  enter  machine-language  programs 
directly  from  the  keyboard  of  your  Apple.  ASCII  characters  can  be 
entered  in  Mini-Assembler  programs,  exactly  as  you  enter  them  in 
the  Monitor. 

Note  that  the  Mini-Assembler  doesn't  accept  labels;  you  must  use 
actual  values  and  addresses. 


Starting  ttie  l\4ini-Assembler 

To  start  the  Mini-Assembler,  first  invoke  the  Monitor  by  typing 
CALL   -151  and  pressing  Return,  and  then  from  the  Monitor, 
type  !  followed  by  Return.  The  Monitor  prompt  character  then 
changes  from  *  to  ! . 

When  you  finish  using  the  Mini-Assembler,  press  Return  from  a 
blank  line  to  return  to  the  Monitor. 

To  enter  code  into  memory,  type  the  address,  a  colon,  and  the 
instruction.  For  example,  after  entering  the  Mini-Assembler,  you 
could  type 

!300:STA  C030 
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You  can  enter  a  series  of  instnictions  by  typing  a  space,  followed  by 
the  instruction,  followed  by  Return: 

!300:STA  C030 
!  LDA  #A0 
!  INX 

Each  succeeding  instruction  is  placed  in  the  next  available  memory 
location.  As  you  type  in  instructions,  each  is  replaced  by  the 
starting  address  of  the  instruction,  the  hexadecimal  valueCs)  of  the 
instruction,  followed  by  mnemonics  describing  the  instruction.  For 
example,  the  sequence  of  instructions  given  above  would  produce 
the  following  on  your  screen: 


0300- 

8D  30  CO 

STA  $C030 

0303- 

A9  AO 

LDA  #$A0 

0305- 

E8 

INX 

When  you're  ready  to  execute  your  program,  press  Return  to  leave 
the  Mini-Assembler  and  return  to  the  Monitor.  Monitor  commands 
can't  be  executed  directly  from  the  Mini-Assembler. 


Using  the  Mini-Assembler 

The  Mini-Assembler  saves  one  address,  that  of  the  program 
counter.  Before  you  start  to  type  a  program,  you  must  set  the 
program  counter  to  point  to  the  location  where  you  want  the  Mini- 
Assembler  to  store  your  program.  Do  this  by  typing  the  address 
followed  by  a  colon. 

After  the  colon,  type  the  mnemonic  for  the  first  instruction  in  your 
program,  followed  by  a  space  and  the  operand  of  the  instruction. 
Now  press  Return.  The  Mini-Assembler  converts  the  line  you  typed 
into  hexadecimal,  stores  it  in  memory  beginning  at  the  location  of 
the  program  counter,  and  then  disassembles  it  again  and  displays 
the  disassembled  line.  It  then  displays  a  prompt  on  the  next  line. 

Now  the  Mini-Assembler  is  ready  to  accept  the  second  instruction 
in  your  program.  To  tell  it  that  you  want  ihe  next  instruction  to 
follow  the  first,  don't  type  an  address  or  a  colon:  just  type  a  space 
and  the  next  instruction's  mnemonic  and  operand,  then  press 
Return.  The  Mini-Assembler  assembles  that  line  and  waits  for 
another. 
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If  the  line  you  type  has  an  error  in  it,  the  Mini-Assembler  beeps 
loudly  and  displays  a  caret  ('^)  under  or  near  the  offending 
character  in  the  input  line.  Most  common  errors  are  the  result  of 
typographical  mistakes:  misspelled  mnemonics,  missing 
parentheses,  and  so  forth.  The  Mini-Assembler  also  rejects  the 
input  line  if  you  forget  the  space  before  or  after  a  mnemonic  or 
include  an  extraneous  character  in  a  hexadecimal  value  or  address. 
If  the  destination  address  of  a  branch  instruction  is  out  of  the  range 
of  the  branch  (more  than  127  locations  distant  from  the  address  of 
the  instruction),  the  Mini-Assembler  flags  this  as  an  error. 

♦  Dollar  signs:  In  this  manual,  dollar  signs  ($)  in  addresses 
signify  that  the  addresses  are  in  hexadecimal  notation.  The 
dollar  signs  are  ignored  by  the  Mini-Assembler  and  can  be 
omitted  in  programs. 

!300:LDX  #02 

0300-    A2  02        LDX    #$02 

!  LDA  $00, X 

0302-    B5  00       LDA     $00, X 

!  STA  $10, X 

0304     95  10       STA    $10, X 

!  DEX 

0306-  CA  DEX 
!  STA  $C030 

0307-  8D  30  CO     STA     $C030 
!  BPL  $0302 

030A-    10  F6       BPL     $0302 

!  BRK 

030C-    00  BRK 

I 

To  leave  the  Mini-Assembler  and  reenter  the  Monitor,  press  Return 
at  a  blank  line. 

Your  assembly-language  program  is  now  stored  in  memory.  You 
can  display  it  with  the  LIST  command: 


*300L 

0300- 

A2 

02 

LDX 

#$02 

0302- 

B5 

00 

LDA 

$00, X 

0304- 

95 

10 

STA 

$10, X 

0306- 

CA 

DEX 

0307- 

80 

30  CO 

STA 

$C030 

030A- 

10 

F6 

BPL 

$0302 

030C- 

00 

BRK 

030D- 

00 

BRK 

030E- 

00 

BRK 

030F- 

00 

BRK 

0310- 

00 

BRK 
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0311- 

00 

BRK 

0312- 

00 

BRK 

0313- 

00 

BRK 

0314- 

00 

BRK 

0316- 

00 

BRK 

0316- 

00 

BRK 

0317- 

00 

BRK 

0318- 

00 

BRK 

0319- 

00 

BRK 

Table  10-1 

Mini-Assembler  address  formats 


Addressing 
mod* 

Format 

Accumulator 

• 

Implied 

* 

Immediate 

#${value} 

Absolute 

^{address} 

Zero  page 

^{address) 

Indexed  zero 
page 

${address},X 
$[address},Y 

Indexed 
absolute 

${address],X 
${address),Y 

Relative 

$laddress] 

Indexed 
indirect 

(.${address],X') 

Indirect 
indexed 

(.$[address},Y:) 

Absolute 
indirect 

maddress}-) 

*  These  instructions  have  no 
operands. 

Mini-Assembler  instruction  formats 

The  Apple  lie  Mini-Assembler  recognizes  66  mnemonics  and  15 
addressing  formats.  The  mnemonics  are  standard,  as  used  in  the 
Synertek  Programming  Manual  (Apple  part  number  A2L0003), 
but  the  addressing  formats  are  somewhat  different,  as  shown  in 
Table  10-1. 

An  address  consists  of  one  or  more  hexadecimal  digits.  The  Mini- 
Assembler  interprets  addresses  the  same  way  the  Monitor  does:  if 
an  address  has  fewer  than  four  digits,  the  Mini-Assembler  adds 
leading  O's;  if  the  address  has  more  than  four  digits,  then  it  uses 
only  the  last  four. 

There  is  no  syntactical  distinction  between  the  absolute  and  zero- 
page  addressing  modes.  If  you  give  an  instruction  to  the  Mini- 
Assembler  that  can  be  used  in  both  absolute  and  zero-page  mode, 
the  Mini-Assembler  assembles  that  instruction  in  absolute  mode  if 
the  operand  for  that  instruction  is  greater  than  $FF,  and  it 
assembles  it  in  zero-page  mode  if  the  operand  is  less  than  $0100. 

Instructions  in  accumulator  mode  and  implied  addressing  mode 
need  no  operands. 

Branch  instructions,  which  use  the  relative  addressing  mode, 
require  the  target  address  of  the  branch.  The  Mini-Assembler 
calculates  the  relative  distance  to  use  in  the  instruction 
automatically.  If  the  target  address  is  more  than  127  locations 
distant  from  the  instruction,  the  Mini-Assembler  sounds  a  bell 
Oaeep),  displays  a  caret  C)  under  the  target  address,  and  does  not 
assemble  the  line. 

If  you  give  the  Mini-Assembler  the  mnemonic  for  an  instruction 
and  an  operand,  and  the  addressing  mode  of  the  operand  cannot 
be  used  with  the  instruction  you  entered,  then  the  Mini-Assembler 
will  not  accept  the  line. 
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Summary  of  Monitor  commands 

Here  is  a  summary  of  the  Monitor  commands,  showing  the  syntax 
diagram  for  each  one. 


Examining  memory 

{adrs}RetuTn  Displays  the  value  contained  in  one 

location. 

{adrsl}.{adrs2]Return    Displays  the  values  contained  in  all 

locations  between  {adrsi}  and  {adrs2s 


Return 
{adrs)L 


Displays  the  values  in  up  to  eight  locations 
following  the  last  opened  location. 

Lists  disassembled  code  starting  at  {adr^ 
and  continuing  until  the  saeen  is  full. 


Ciianglng  the  contents  of  memory 

{adrs}:{va[\{val)...         STORE  command.  Stores  the  values  in 

consecutive  memory  locations  starting  at 
{adrs}. 

•.{vat\{val\...  Stores  values  in  memory  starting  at  the 

next  changeable  location. 


IVIoving  and  comparing 


{dest]<{starft.{end\U 


{dest]<{start].{end\V 


MOVE  command.  Copies  the  values  in 
the  range  {star^.ienc^  into  the  range 
beginning  at  {des&. 

VERIFY  command.  Compares  the  values 
in  the  range  [starfi.iendi  to  those  in  the 
range  beginning  at  {desfi. 
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The  Register  command 

Control-E 


EXAMINE  command.  Displays  the 
locations  where  the  contents  of  the 
65C02's  registers  are  stored  and  opens 
them  for  changing. 


Miscellaneous  Monitor  commands 


INVERSE  command.  Sets  inverse  display 
mode. 

NORMAL  command.  Sets  normal  display 
mode. 

BASIC  command.  Enters  the  language 
currently  active  (normally  Applesoft). 

CONTINUE  BASIC  command.  Returns  to 
the  language  currently  active  (normally 
Applesoft). 

Adds  the  two  values  and  prints  the 
hexadecimal  result. 

Subtracts  the  second  value  from  the  first 
and  prints  the  result. 

Redirects  output  to  the  device  connected 
to  port  number  {porii.  If  {pori^O,  sends 
output  to  the  video  display.  Use  only 
when  the  enhanced  video  firmware  is  not 
active  (checkerboard  cursor). 

Redirects  output  to  video  display  when 
enhanced  video  firmware  is  active  (solid 
block  cursor). 

Takes  input  from  the  device  connected  to 
port  number  {pott.  If  {port=0,  accepts 
input  from  the  keyboard. 

USER  command.  Jumps  to  the 
machine-language  subroutine  at 
location  $03F8. 


N 

Control-B 

Control-C 

{vali+ivali 
{val}-{val} 
{port}Control-P 


Escape  Control-Q 

{porflControl-K 

Control-Y 
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Running  and  listing  programs 

{adrs}G  Transfers  control  to  the  machine- 

language  program  beginning  at  {adrs}. 

{adrs}L  Disassembles  and  displays  20  instmctions 

starting  at  [adr^.  Subsequent  L's  display 
20  more  instmctions  each. 
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Most  of  this  manual  desaibes  functions — ^what  the  Apple  lie  does. 
This  chapter,  on  the  other  hand,  describes  objects — the  pieces  of 
hardware  the  Apple  He  uses  to  carry  out  its  functions.  If  you  are 
designing  a  device  to  connect  to  the  Apple  lie  back  panel,  or  if  you 
just  want  to  know  more  about  how  the  Apple  He  is  built,  you  should 
study  this  chapter. 


Table  11-1 

Environmental  specifications 


Operating 
temperature 

Relative 
humidity 


lO"*  to  40°  C 
(50°  to  104°  F) 

20%  to  95% 


Environmental  specifications 

The  Apple  lie  is  quite  sturdy  when  used  in  the  way  it  was  intended:  as 
a  transportable  computer,  made  for  use  in  an  indoor  environment. 
You  can  carry  it  by  its  handle  from  room  to  room,  but  for  longer 
trips  you  should  use  its  carrying  case  or  some  other  protective 
container  (such  as  an  attach^  case).  Table  11-1  defines  the 
conditions  under  which  the  Apple  lie  is  designed  to  function 
properly. 

You  should  treat  the  Apple  lie  with  the  same  kind  of  care  as  any 
other  electrical  appliance;  protect  it  from  physical  abuse,  and  be 
careful  not  to  bump  it  against  furniture  when  you  move  it  around. 
Put  it  in  an  attache  case  or  other  protective  covering  if  you  carry  it 
outside.  You  should  also  protect  the  mechanical  keyboard  and  the 
electrical  connectors  inside  the  case  from  spilled  liquids, 
particularly  those  with  dissolved  contaminants,  such  as  soups,  fruit 
juices,  and  carbonated  soft  drinks. 

In  normal  operation  (with  the  handle  locked  in  its  down  position), 
enough  air  flows  through  the  openings  in  the  case  to  keep  the  insides 
from  getting  too  hot  If  you  do  overheat  your  Apple  lie — ^for 
example,  by  blocking  the  upper  or  lower  ventilation  openings — the 
first  symptom  will  be  erratic  operation,  such  as  unexpectedly 
changed  data.  (The  memory  devices  in  the  Apple  He  are  especially 
sensitive  to  heat)  Letting  the  machine  cool  down  by  turning  it  off 
for  a  while  and  unblocking  the  vents  before  using  it  again  will  bring  it 
back  to  normal  operation.  The  only  exception  to  this  is  if  you  have 
gotten  your  Apple  lie  too  hot  and  physically  damaged  some 
internal  component. 

Disks  are  another  heat-sensitive  element  of  the  system.  If  the  built- 
in  drive  becomes  too  hot,  a  disk  within  can  warp  or  even  melt.  A 
melted  or  warped  disk  can't  be  used  again. 
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Power  requirements 

The  electrical  power  used  by  the  Apple  He — and  everything  that 
draws  power  from  it — ^is  limited  by  the  capacities  of  the  computer's 
power  supply  and  internal  voltage  converter.  This  section  describes 
these  limits  for  the  USA  external  power  supply.  Appendix  G 
describes  them  for  models  built  for  other  countries.  The  internal 
voltage  converter  is  the  same  on  all  models. 


The  external  power  supply 

If  you  purchased  your  Apple  lie  outside  the  USA,  consult 
Appendix  G  for  external  power  supply  characteristics. 

The  external  power  supply  operates  on  normal  household  AC 
power  and  provides  DC  power  to  the  Apple  lie  internal  converter. 
The  basic  specifications  of  the  external  power  supply  are  listed  in 
Table  1 1-2.  The  Apple  lie  external  power  supply's  cord  must  be 
plugged  into  a  three-wire  115-volt  (nominal)  outlet.  A  two-wire 
outlet  is  not  properly  grounded — using  it  will  damage  the  external 
power  supply  and  perhaps  the  Apple  lie  as  well.  The  line  voltage 
must  be  in  the  range  given  in  Table  1 1-2. 


Warning      Important  safety  instructions:  Tliis  product  Is  equipped  with  a 
three-wire  grounding-type  plug— a  plug  having  a  third 
(grounding)  pin.  This  plug  wiil  only  fit  into  a  grounding-type 
AC  outlet.  This  Is  a  safety  feature. 

If  you  are  unable  to  insert  the  plug  into  the  outlet,  contact  a 
licensed  electrician  to  replace  the  outlet  and,  if  necessary. 
Install  a  grounding  conductor. 

Do  not  defeat  the  purpose  of  the  grounding-type  plug. 

Tablo11-2 

Power  supply  specifications 


Line  voltage  105  to  129  VAC,  60  Hz 

Maximum  power  25  W 
consumption 

Supply  voltage  +15  VDC  (nominal) 

Supply  current  1.2  A  (nominal) 
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Signal 


The  external  power  connector 

The  external  power  supply  is  attached  to  the  internal  converter  by 
means  of  a  7-pin  DIN  connector.  The  conneaor  pins  are  identified 
in  Figure  11-1  and  Table  11-3. 

Table  11-3 

External  power  connector  signals 


1          Not  connected 

Pin 

Signal 

Dsscrlption 

2, 3       Signal  ground 

4          Shield  ground 

1,7 

Not  connected 

5,6       +15VDC 
7          Not  connected 

2,3 
4 

Ground 
Chassis 

Common  electrical  ground 
Chassis  ground 

Figure  11-1 

5,6 

+15V 

+15-volt  DC  input  to  converter 

External  power  connector 

The  internal  converter 

The  internal  converter  in  the  Apple  lie  operates  with  a  supply 
voltage  from  9  to  20  volts  DC  as  provided  by  the  external  power 
supply  or  its  equivalent  The  internal  converter  provides  enough 
low-voltage  electrical  power  for  the  built-in  electronics  plus  an 
external  disk  drive  attached  via  the  19-pin  connector.  The  basic 
specifications  of  the  internal  converter  are  listed  in  Table  11-4. 
Minus  5  volts  is  derived  from  the  -12  volts  (nominal)  provided  by 
the  voltage  converter. 

Table  11-4 

Internal  converter  specifications 


Input  voltags 

+9  to  20  VDC 

Maximum  powor 

25  W 

consumption 

Supply  voltages 

+5V±5% 

+12V  ±10% 

-12V  ±10% 

Maximum  supply 

+5V:  1.5  A 

currants 

+  12V:  0.6  A  continuous 

0.9  A  intermittent 

1.5  A  surge  (for  <  100  ms) 

-12V:   100  mA 

(-5V:    50  mA) 

Maximum  case 

60°  C               (140°  F) 

temperature 
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The  Apple  lie  uses  a  switching-type  internal  voltage  converter  as  a 
power  supply.  It  is  small  and  lightweight,  and  it  generates  less  heat 
than  other  types  of  voltage  converters. 

The  voltage  converter  works  by  using  the  DC  voltage  input  to  power 
a  variable-frequency  oscillator.  The  oscillator  drives  a  small 
transformer  with  several  separate  windings  to  produce  the  different 
voltages  required.  A  circuit  compares  the  voltage  of  the  +5-volt 
supply  with  a  reference  voltage  and  feeds  an  error  signal  back  to  the 
oscillator  circuit.  The  oscillator  circuit  uses  the  error  signal  to 
control  the  duty  cycle  of  its  oscillation  and  keep  the  output  voltages 
in  their  normal  ranges. 

The  converter  includes  circuitry  to  protect  itself  and  the  other 
electronic  parts  of  the  Apple  lie  by  limiting  all  three  output  voltages 
whenever  it  detects  one  of  the  following  malfunctions: 

D  any  supply  voltage  short-circuited  to  ground 

D  any  output  voltage  outside  the  normal  range 

Whenever  one  of  these  malfunctions  occurs,  the  protection  circuit 
varies  the  duty  cycle  of  the  oscillator,  and  all  the  output  voltages 
drop  to  0  if  they  cannot  be  brought  back  into  their  normal  range. 


Apple  He  overall  block  diagram 

Figure  11-2  is  an  overall  block  diagram  of  the  Apple  He.  The 
following  sections  contain  more  detailed  diagrams  of  the  major 
parts  of  the  machine.  A  full  set  of  schematic  diagrams  of  the 
Apple  He  appears  later  in  this  chapter. 
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Chapter  1 1 :  Hardv\/are  Implementation 


CMOS  (complementary  metal- 
oxide  semiconductor)  Is  a  way 
of  making  Integrated  circuits 
that  require  less  power  to 
operate  than  other  technologies 
such  as  NMOS  (negative-doped 
metal-oxide  semiconductor), 
used  by  the  6502. 


These  Instructions  are  described 
in  Appendix  A. 


The  65C02  microprocessor 

The  Apple  no  uses  a  CMOS  6502  (designated  as  65C02) 
microprocessor  as  its  central  processing  unit  (CPU).  The  65C02  in 
the  Apple  lie  runs  at  a  dock  rate  of  1.023  MHz  and  performs  up  to 
500,000  8-bit  operations  per  second. 

♦  Note:  The  dock  rate  is  not  a  very  good  criterion  for  comparing 
different  types  of  microprocessors.  The  65C02  has  a  simpler 
instruction  cycle  than  most  other  microprocessors  and  it  uses 
instruction  pipelining  for  faster  processing.  The  speed  of  the 
65C02  with  a  1-MHz  dock  is  equivalent  to  many  other  types  of 
microprocessors  with  dock  rates  up  to  5  MHz. 

In  addition  to  requiring  less  power  than  earlier  NMOS  6502 
processors,  the  65C02  in  the  Apple  lie  has  27  new  instructions. 
However,  programs  that  use  these  additional  instructions  are  not 
backward  compatible  with  other  Apple  II  series  computers  that  are 
not  equipped  with  a  CMOS  6502. 


65C02  block  diagram 

Figure  11-3  is  a  block  diagram  of  the  65C02  microprocessor. 
Table  11-5  contains  the  general  spedfications  of  this  chip.  The 
65C02  has  a  l6-bit  address  bus,  giving  it  an  address  space  of 
64K  bytes.  The  Apple  lie  uses  special  techniques  to  address  a  total 
of  more  than  64K  (see  Chapter  2). 


The  65C02  microprocessor 
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65C02  block  diagram  (copyright  ©  1982  by  NCR  Corporation;  used  by  permission) 
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Table  11-5 

65C02  microprocessor  specifications 


Type 

Register 
complement 


Data  bus 
Address  bus 
Address  range 
Interrupts 

Operating  voltage 
Power  dissipation 


65C02 

8-bit  accumulator  (A) 
8-bit  index  registers  CX,Y) 
8-bit  stack  pointer  (S) 
8-bit  processor  status  0') 
l6-bit  program  counter  (PC) 

8  bits  wide 

l6  bits  wide 

65,536  C64K) 

IRQ  (maskable) 
NMI  (nonmaskable) 
BRK  (programmed) 

+5V  (±5%) 

5  mW  (at  1  MHz) 


65C02  timing 

The  Apple  lie's  operation  is  controlled  by  a  set  of  synchronous 
timing  signals,  sometimes  called  clock  signals.  The  Apple  lie  uses  a 
14.318-MHz  master  timing  signal,  called  MM,  to  produce  all  the 
other  timing  signals.  These  timing  signals  perform  two  major  tasks: 
controlling  the  computing  functions,  and  generating  the  video 
display.  The  timing  signals  directly  involved  with  the  65C02's 
operation  are  described  in  this  section.  Other  timing  signals  are 
described  later  in  this  chapter. 

The  relationships  of  the  main  65C02  timing  signals  are  diagrammed 
in  Figure  11-4,  and  the  signals  are  listed  in  Table  11-6.  The  65C02 
dock  signals  are  0I  and  0O,  complementary  signals  at  a  frequency 
of  1.0227  MHz.  The  Apple  lie  signal  0O  is  similar  to  the  signal  02  in 
Appendix  A  (it  isn't  identical — it's  a  tiny  bit  early). 


The  65C02  microprocessor 
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65C02  timing  signals 

Table  11-6 

65C02  tinning  signai  descriptions 


Signal 


Description 


14M 

VID7M 
Q3 

00 
01 


Master  oscillator,  14.318  MHz;  also  80-column 

dot  clock 

Intermediate  timing  signal  and  40-column  dot  clock 

Intermediate  timing  signal,  2.045  MHz  with 

asymmetrical  duty  cycle 

Phase  0  of  65C02  clock,  1.0227  MHz;  complement  of  0I 

Phase  1  of  65C02  clock,  1.0227  MHz;  complement  of  0O 
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The  65C02's  operations  are  related  to  the  dock  signals  in  a  simple 
way:  internal  during  0I,  external  during  0O.  The  65C02  puts  an 
address  on  the  address  bus  during  0I.  This  address  is  valid  not 
later  than  110  nanoseconds  after  0I  goes  high  and  remains  valid 
through  all  of  0O.  The  65C02  reads  or  writes  data  during  0O.  If  the 
65C02  is  writing,  the  read/write  signal  is  low  during  0O  and  the 
65C02  puts  data  on  the  data  bus.  The  data  are  valid  not  later  than 
75  nanoseconds  after  0O  goes  high.  If  the  65C02  is  reading,  the 
read/write  signal  remains  high.  Data  on  the  data  bus  must  be  valid 
no  later  than  50  nanoseconds  before  the  end  of  0O. 

More  information  about  the  65C02  and  its  instruction  set  is  in 
Appendix  A. 


The  custom  integrated  circuits 

Most  of  the  circuitry  that  controls  memory  and  I/O  addressing  in 
the  Apple  lie  is  m  five  custom  integrated  circuits: 

a  the  memory  management  unit  (MMU) 

n  the  input-output  unit  OOU) 

a  the  timing  generator  (TMG) 

a  the  general  logic  unit  (GLU) 

D  the  disk  controller  unit,  also  known  as  the  Integrated  Woz 
Machine  OWM) 

The  soft  switches  that  control  the  various  I/O  and  addressing  modes 
of  the  Apple  lie  are  addressable  flags  inside  the  MMU,  lOU, 
and  GLU.  The  functions  of  the  MMU  and  lOU  are  not  as 
independent  as  their  names  suggest;  working  together,  they 
generate  all  the  addressing  signals.  For  example,  the  MMU 
generates  the  RAM  address  signals  for  the  CPU,  while  the  lOU 
generates  similar  RAM  address  signals  for  the  video  display  and 
most  I/O  hardware  addresses. 


The  memory  management  unit  (MMU) 

The  circuitry  inside  the  MMU  implements  these  soft  switches: 

a  Page  2  display  CPage2)  (described  in  Chapter  5) 

D  high-resolution  mode  (HiRes)  (Chapter  5) 

a  store  to  80-column  display  (SOStore)  (Chapter  5) 

a  select  bank  2  (Bank2)  (Chapter  2) 
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Important 


n  enable  bank-switched  RAM  (EnlCRAM)  (Chapter  2) 

n  read  auxiliary  memory  (RAMRd)  (Chapter  2) 

n  write  auxiliary  memory  (RAMWrt)  (Chapter  2) 

D  auxiliary  stack  and  zero  page  (AltZP)  (Chapter  2) 

D  reset  mouse  Y  interrupt  (RstYInt)  (Chapter  9) 

D  reset  mouse  X  interrupt  (RstXInt)  (Chapter  9) 

These  switches  are  available  on  MMU  pin  21,  which  is  connected  to 
bit  7  on  the  data  bus.  Figure  11-5  shows  the  MMU  pinouts; 
Table  11-7  describes  the  signals. 

A  signal  name  followed  by  an  asterisk  Is  active  low— that  Is,  it  is 
true  whien  the  signal  Is  at  a  TIL  high  (+5V)  level. 

The  64K  dynamic  RAMs  used  in  the  Apple  lie  use  a  multiplexed 
address,  as  described  later  in  this  chapter.  The  MMU  generates  this 
multiplexed  address  for  memory  reading  and  writing  by  the 
65C02  CPU. 


Table  11-7 

MMU  signal  descriptions 


GND 

1^ 

40 

AO 

2 

39 

00 

3 

38 

Q3 

4 

37 

PRAS* 

5 

36 

RAO 

6 

35 

RA1 

7 

34 

RA2 

8 

33 

RA3 

9 

32 

RA4 

10 

31 

RA5 

11 

30 

RA6 

12 

29 

RA7 

13 

28 

R/W* 

14 

27 

INH* 

15 

26 

C06X* 

16 

25 

EN80* 

17 

24 

KBD* 

18 

23 

R0MEN2* 

19 

22 

R0MEN1* 

20 

21 

A1 

A2 

A3 

A4 

A5 

A6 

A7 

A8 

A9 

A10 

A11 

A12 

A13 

A14 

A15 

4-5V 

SELIO* 

CASEN* 

C07X* 

MD7 


Pin 


Signal 


Description 
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MMU  pinouts 


1 

GND 

2 

AO 

3 

00 

4 

Q3 

5 

PRAS* 

6-13 

RA0-RA7 

14 

R/W 

15 

INH* 

16 

co6x* 

17 

EN80* 

18 

KBD* 

19 

ROMEN2 

20 

ROMENl 

21 

MD7 

22 

C07X 

23 

CASEN* 

24 

SELIO* 

25 

+5V 

26-40 

A15-A1 

Power  and  signal  common 

65C02  address  input 

Clock  phase  0  input 

Timing  signal  input 

Memory  row-address  strobe 

Mukiplexed  address  output 

65C02  read-write  control  signal 

Inhibits  main  memory  (tied  to  +5X0 

Causes  $C06x  outputs  to  go  to  0  during  0O 

Enables  auxiliary  RAM 

Enables  keyboard  data  bits  0-6 

Enables  ROM  (tied  to  ROMENl*) 

Enables  ROM  (tied  to  ROMEN2*) 

State  of  MMU  flags  on  data  bus  bit  7 

Causes  $C07x  outputs  to  go  to  0  during  0O 

Enables  main  RAM 

Goes  to  0  during  0O  for  any  access  to 

$C0  page  except  $C08x,  Bx,  Cx,  or  Fx 

Power 

65C02  address  input 
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GND 

1^ 

40 

GR 

2 

39 

SEGA 

3 

38 

SEGB 

4 

37 

VC 

5 

36 

80COL* 

6 

35 

CASSO 

7 

34 

SPKR 

8 

33 

MD7 

9 

32 

YMOVE 

10 

31 

(N.C.) 

11 

30 

(N.C.) 

12 

29 

PDLO/XMOVE 

13 

28 

R/W* 

14 

27 

RESET- 

15 

26 

IRQ* 

16 

25 

RAO 

17 

24 

RA1 

18 

23 

RA2 

19 

22 

RA3 

20 

21 

HO 

SYNC* 

WNDW* 

CLRGAT* 

RA10* 

RA9* 

VIDD6 

VIDD7 

KSTRB 

AKD 

lOUSELIO* 

A6 

+  5V 

Q3 

aO 

PRAS* 

RA7 

RAG 

RA5 

RA4 


The  input/output  unit  (lOU) 

Input/output  unit  (lOU)  implements  the  following  soft  switches,  all 
described  in  Chapters  2  and  3: 

D  Page  2  display  0Page2) 

D  high-resolution  mode  (HiRes) 

D  text  mode  (XEXT) 

a  mixed  mode  (MIXED) 

D  80-column  display  (80Col) 

a  character-set  select  (AltChar) 

D  any-key-down  (AKD) 

D  mouse  movement  (XO,  YO) 

D  vertical  blanking  interrupt  (VBlInt) 

These  switches  are  available  on  lOU  pin  9,  which  is  connected  to 
bit  7  on  the  data  bus.  Figure  11-6  shows  the  lOU  pinouts;  Table  11-8 
describes  the  signals. 

The  64K  dynamic  RAMs  used  in  the  Apple  lie  require  a  multiplexed 
address,  as  described  later  in  this  chapter.  The  lOU  generates  this 
multiplexed  address  during  clock  phase  1  for  the  data  transfers 
required  for  display  and  memory  refresh.  The  way  this  address  is 
generated  is  described  under  "The  Video  Counters"  in  this  chapter. 

Table  11-8 

lOU  signal  descriptions 


Pin 


Signal 


Description 


GND 

GR 

SEGA 


SEGB 


VC 


Figure  11-6 

lOU  pinouts 


Power  and  signal  common 

Graphics  mode  enable 

In  text  mode,  works  with  VC  (see  pin  5) 

and  SEGB  to  determine  character  row 

address 

In  text  mode,  works  with  VC  (see  pin  5) 

and  SEGA;  in  graphics  mode,  selects 

high  resolution  when  low,  low  resolution 

when  high 

Displays  vertical  counter  bit:  in  text 

mode,  SEGA,  SEGB,  and  VC  determine 

which  of  the  eight  rows  of  a  character's 

dot  pattern  to  display,  in  low  resolution, 

selects  upper  or  lower  block  defined  by  a 

byte 


The  custom  integrated  circuits 
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Table  11-8  (continued) 
lOU  signal  descriptions 


Pin 


Signal 


Description 


6 

BOCOL* 

7 

CASSO 

8 

SPKR 

9 

MD7 

10 

YMOVE 

11 

N.C. 

12 

N.C. 

13 

PDLO/XMOVE 

14 

R/W 

15 

RESET* 

16 

IRQ* 

17-24 

RA0-RA7 

25 

PRAS* 

26 

00 

27 

Q3 

28 

+5V 

29 

A6 

30 

lOUSELIO* 

31 

AKD 

32 

KSTRB 

33,34 

VIDD7,VIDD6 

35,36 

RA9*,RA10* 

37 

CLRGAT' 

38 

WNDW* 

39 

SYNC* 

40 

HO 

80-column  video  enable 

Reserved 

Speaker  output  signal 

Internal  lOU  flags  for  data  bus  (bit  7) 

Detects  mouse  movement  along  Y  axis 

Not  used 

Not  used 

Detects  mouse  movement  along  X  axis 

65C02  read-write  control  signal 

Power  on  and  reset  output 

Maskable  interrupt  line  to  65C02 

Video  refresh  multiplexed  RAM  address 
(phase  1) 

Row-address  strobe  (phase  0) 

Master  dock  phase  0 

Intermediate  timing  signal 

Power 

Address  bit  6  from  65C02 

Derived  from  the  SELIO*  output  for  MMU 
pin  24 

Any-key-down  signal 

Keyboard  strobe  signal 

Video  display  data  bits 

Video  display  control  bits 

Color-burst  gate  (enable) 

Displays  blanking  signal 

Displays  synchronization  signal 

Displays  horizontal  timing  signal  Oow  bit 
of  character  counter) 


244 


Chapter  11:  Hardware  Implementation 


14M 

1 

W 

20 

7M 

2 

19 

CREF 

3 

18 

HO 

4 

17 

VIDD7 

5 

16 

SEGB 

6 

15 

TEXT 

7 

14 

CASEN* 

8 

13 

80COL* 

9 

12 

GND 

10 

11 

Figure  n -7 

TMG  pinouts 


+  5V 

PRAS* 

(N.C.) 

PC  AS* 

Q3 

00 

0l 

VID7M 

LDPS* 

TMGEN* 


The  timing  generator  (TIVIG) 

A  custom  timing  generator  chip  (TMG)  generates  several  timing 
and  control  signals  in  the  Apple  lie.  The  TMG  pinouts  are  shown  in 
Figure  11-7;  the  signals  are  listed  in  Table  11-9. 

Table  11-9 

TMG  signal  descriptions 


Pin        Signal 


Description 


1  14M  14.318-MHz  master  timing  signal  input 

2  7M  7.159-MHz  timing  signal 

3  CREF  3.5795-MHz  color  reference  timing  signal 

4  HO  Horizontal  video  timing  signal 

5  VIDD7  Video  data  bit  7 

6  SEGB  Video  timing  signal 

7  TEXT  Video  display  text-modes  enable 

8  CASEN*  RAM  enable  (CAS  enable) 

9  80COL*  Enables  80-column  display  mode 

10  GND  Power  and  signal  common 

11  TMGEN*  Enables  master  timing 

12  LDPS*  Video  shift-register  load  enable 

13  VID7M  Video  dot  dock  enable,  7  MHz  or  continuous  0 

14  0l  Phase  1  system  dock 

15  00  Phase  0  system  clock 

16  Q3  Intermediate  timing  and  strobe  signal 

17  PCAS*  RAM  column-address  strobe 

18  N.C.  Reserved  for  testing 

19  PRAS*  RAM  row-address  strobe 

20  +5V  Power 


The  general  logic  unit  (GLU) 

The  general  logic  unit  is  a  single  chip  that  contains  the 
miscellaneous  logic  required  for  the  system.  It  provides 

a  all  RAM  read/write  timing 

n  double  high-resolution  enable/disable 

D  soft-switch  status  registers 

a  write  command  registers 

D  lOU  control  for  mouse  interrupts 

D  double  high-resolution  soft  switches 


Ttie  custom  Integrated  circuits 
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1 

^    24 

AO 

2 

23 

A3 

3 

22 

A4 

4 

21 

A5 

5 

20 

A6 

6 

19 

A7 

7 

18 

00 

8 

17 

SELIO" 

9 

16 

GR 

10 

15 

RESET* 

11 

14 

GND 

12 

13 
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GLU  pinouts 


+  5V 

SER* 

lOUHOLE 

DISK* 

7M 

CREF 

(N.C.) 

(N.C.) 

TEXT 

R/W* 

MD7 

GLUEN* 


The  GLU's  pin  assignments  are  shown  in  Figure  11-8  and  its  signals 
are  listed  in  Table  11-10. 

Table  n-10 

GLU  signal  descriptions 

Pin  Signal  Description 


1 
2,3-7 

8 


14M 
A0,A3-A7 

00 

SELIO* 


10 

GR 

11 

RESET* 

12 

GND 

13 

GLUEN* 

14 

MD7 

15 

R/W* 

16 

TEXT 

17,18 

N.C. 

19 

CREF 

20 

7M 

21 

DISK* 

22 

lOUHOLE 

23 

SER* 

24 

+5V 

Master  clock  (14.318  MHz) 

Address  lines  to  select  least  significant  byte 
of  addresses  on  CO  page 

Phase  0  of  1.0227-MH2  processor  sync 
clock 

Device  select  for  selecting  most  significant 
byte  of  the  address 

Graphics  mode  select  line 

Master  reset  for  system;  resets  GLU 

Ground  reference  and  negative  supply 

Enables  GLU 

Indicates  status  of  MMU  flags  on  data  bus 
bit  7 

Read/write  qualifier  input  from  processor 

Signal  used  to  generate  video  timing  in 
double  high-resolution  or  not-graphics 

Not  used 

Color  reference  signal 

7-MHz  clock  output 

Disk  controller  device  select  output 

Controls  lOUSELIO 

Serial  controller  device  select  output 

+5  volt  supply 
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The  disk  controller  unit  (IWM) 


For  further  information  on  GCR, 
refer  to  "Dislc  i/O.' 


SEEKPHO 

1     ^ 

28 

SEEKPH2 

2 

27 

AO 

3 

26 

A1 
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25 

A2 

5 

24 

A3 
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23 

DISK* 

7 

22 

WRDATA 

8 

21 

WRREQ* 

9 

20 

DO 

10 

19 

D1 

11 

18 

D2 

12 

17 

D3 

13 

16 

GND 

14 

15 
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IWM  pinouts 


SEEKPHI 

SEEKPH3 

+  5V 

Q3 

7M 

RESET* 

RDDATA 

WRPROT 

DR1* 

DR2* 

D7 

D6 

D5 

D4 


The  IWM  (for  Integrated  Woz  Machine)  is  a  disk  controller  that 
includes,  on  a  single  chip,  all  the  capabilities  of  the  disk  controller 
card  originally  designed  by  Steve  Wozniak  in  1977. 

Right  after  reset,  the  IWM  is  an  integrated  GCR  (group  code 
recording)  disk  drive  controller.  It  also  has  a  status  register,  mode 
register,  and  multiple  operating  modes.  It  provides  both 
synchronous  and  asynchronous  modes,  and  a  fast  mode  with  a  data 
rate  twice  that  of  normal  disk  I/O  speeds.  Figure  11-9  shows  the 
IWM  pin  assignments;  Table  11-11  describes  the  IWM  signals. 

Table  11-11 

IWM  signal  descriptions 


Pin 


Signal 


Description 


1  SEEKPHO       Stepper  motor  control  phase  0,  one  of  four 

programmable  disk  drive  motor  phase 
outputs. 

2  SEEKPH2       Stepper  motor  control  phase  2. 

3  AO  The  data  input  to  the  state  bit  selected 

by  Al  to  A3. 

4r-6  A1-A3  These  three  inputs  select  one  of  the  eight 

bits  in  the  state  register  to  be  updated. 

7  DISK*  Device  enable.  The  falling  edge  of 

DISK*  latches  information  on  Al  to  A3. 
The  rising  edge  of  either  Q3  or  DISK* 
qualifies  write  register  data. 

8  WRDATA       The  serial  data  output.  Each  1-bit  causes  a 

transition  on  this  output. 

9  WRREQ*        This  signal  is  a  programmable  buffered 

output  line. 

10-13         D0-D3  DO  to  D7  make  up  the  bidirectional  data 

bus. 

14  GND  Ground  reference  and  negative  supply. 

15-18         D4-D7  The  remaining  bits  of  the  bidirectional 

data  bus. 

19  DR2*  Drive  2  select. 
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Table  11-11  (continued) 
IWM  signal  descriptions 


Pin 

Signal 

Description 

20 

DRl* 

Drive  1  select. 

21 

WRPROT 

Write-protect  input;  this  can  be  polled  via 
bit  7  of  the  status  register. 

22 

RDDATA 

Serial  data  input  line.  The  rWM 
synchronizes  the  falling  transition  of  each 
pulse. 

23  RESET*  IWM  reset:  places  all  IWM  outputs  in  their 

inactive  state  and  sets  all  state  and  mode 
register  bits  to  0. 


24 

7M 

7-MHz  dock  input. 

25 

Q3 

A  2.0-MHz  clock  input  used  to  qualify  the 
timing  of  the  serial  data  being  written  or 
read. 

26 

+5V 

The  +5  volt  supply. 

27 

SEEKPH3 

Stepper  motor  control  phase  3. 

28 

SEEKPHl 

Stepper  motor  control  phase  1. 

Memory  addressing 

The  65C02  microprocessor  can  directly  address  65,536  locations. 
The  Apple  lie  uses  this  entire  address  space,  and  then  some:  some 
areas  in  memory  are  used  for  more  than  one  function.  The 
following  sections  describe  the  memory  devices  used  in  the 
Apple  lie  and  the  way  they  are  addressed.  Input  and  output  also  use 
portions  of  the  memory  address  space;  refer  to  Chapter  2  for 
information. 

Figure  11-10  illustrates  the  Apple  lie's  overall  memory  bus 
organization  and  memory  selection  signals. 

♦  Note:  Some  Apple  He's  have  ROMs  with  27xx  designations, 
some  have  23xx.  They  are  functionally  equivalent. 
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23128  ROM  pinouts  (in  type 
23256  ROM,  pin  #27  is  A14) 
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Figure  11-10 

Memory  bus  organization 


ROM  addressing 

In  the  Apple  lie  the  following  programs  are  permanently  stored  in  a 
type  23128  l6K-by-8-bit  ROM  (Figure  11-11): 

D  Applesoft  editor  and  interpreter 

a  Monitor 

n  enhanced  video  firmware 


UnlDisl<  3.5 


Memory  expansion 


The  version  of  ]he  Appie  lie  ttiat  supports  the  UniDisl<  3.5  uses  a 
23256  32K-by-8-bit  ROM.  it  needs  the  extra  space  for  the 
Protocol  Converter,  Mini-Assembler,  and  other  added  functions 
that  it  supports. 

The  Apple  lie  that  supports  the  memory  expansion  card  also 
uses  the  23256  ROM  10. 
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Figure  11-12 

2316  ROM  pinouts 


The  ROM  is  enabled  by  two  signals  called  ROMENl  and  ROMEN2. 
(In  the  Apple  lie,  ROMENl  and  ROMEN2  are  electrically 
connected.)  The  segment  of  the  ROM  enabled  by  ROMENl 
occupies  the  memory  address  space  from  $C100  through  $DFFF. 
The  address  space  from  $C300  through  $C3FF  and  much  of  $C800 
through  $CFFF  contains  the  enhanced  video  firmware. 

These  ROM  address  allocations  are  approximately  true  (some  space 
sharing  takes  place): 

n  ROM  addresses  $C000  through  $COFF  are  never  available. 

n  ROM  addresses  $C100  and  $C200  are  entry  points  to  firmware  for 
serial  ports  1  and  2,  respectively. 

n  ROM  address  $C400  is  the  entry  point  to  mouse  interface 
support. 

D  ROM  addresses  $C500  through  $C5FF  are  reserved. 

D  ROM  address  $C600  is  the  entry  point  to  firmware  for  the  built-in 
and  external  disk  drives.  The  built-in  drive  is  considered  slot  6 
drive  1  or  its  equivalent.  The  external  drive  is  considered  slot  6 
drive  2. 

D  ROM  addresses  starting  at  $C700  support  (from  the  Monitor)  the 
external  drive  as  if  it  were  slot  7  drive  1,  for  external-drive  startup 
only. 

D  Addresses  $D000  through  $F7FF  contain  the  Applesoft  BASIC 
interpreter;  addresses  $F800  through  $FFFF  contain  the  Monitor 
firmware. 
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The  Apple  He  that  supports  the  memory  expansion  card  has  a 
ROM  map  that  is  different  from  that  given  for  the  originai  and 
UniDisl<  3.5  iic.  The  memory  expansion  ROM  map  is  provided  in 
Appendix  i. 

The  other  ROMs  in  the  Apple  lie  are  a  type  23l6  ROM  (Figure  11-12) 
used  for  the  keyboard  character  decoder,  and  a  type  2364  ROM 
(Figure  11-13)  used  for  character  sets  for  the  video  display.  This 
2364  ROM  is  rather  large  because  it  includes  a  section  of  straight- 
through  bit-mapping  for  the  graphics  modes.  This  way,  graphics 
display  video  can  pass  through  the  same  circuits  as  text  without 
additional  switching  circuitry. 


Figure  11-13 

2364  pinouts 
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RAM  addressing 

The  RAM  (programmable)  memory  in  the  Apple  lie  is  used  both  for 
program  and  data  storage  and  for  the  video  display.  The  areas  in 
RAM  that  are  used  for  the  display  are  accessed  both  by  the  65C02 
microprocessor  and  by  the  video  display  circuits.  In  some 
computers,  this  dual  access  results  in  addressing  conflicts  (cycle 
stealing)  that  can  cause  temporary  dropouts  in  the  video  display. 
This  problem  does  not  occur  in  the  Apple  lie,  thanks  to  the  way  the 
microprocessor  and  the  video  circuits  share  the  memory. 

The  memory  circuits  in  the  Apple  lie  take  advantage  of  the  two- 
phase  system  clock  to  interleave  the  microprocessor  memory 
accesses  and  the  display  memory  accesses  so  that  they  never 
interfere  with  each  other.  The  microprocessor  reads  or  writes  to 
RAM  only  during  0O,  and  the  display  circuits  read  data  only 
during  0l. 
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Figure  11-14 

64  K  RAM  pinouts 


Dynamic  RAM  refreshment 

The  image  on  a  video  display  is  not  permanent;  it  fades  rapidly  and 
must  be  refreshed  periodically.  To  refresh  the  video  display,  the 
Apple  lie  reads  the  data  in  the  active  display  page  and  sends  them 
to  the  display.  To  prevent  visible  flicker  in  the  display,  and  to 
conform  to  standard  practice  for  broadcast  video,  the  Apple  lie 
refreshes  the  display  60  times  per  second. 

The  dynamic  RAM  devices  used  in  the  Apple  lie  also  need  a  kind  of 
refreshment,  because  the  data  are  stored  in  the  form  of  electric 
charges  that  diminish  with  time  and  must  be  replenished.  The 
Apple  lie  is  designed  so  that  refreshing  the  display  also  refreshes 
the  dynamic  RAMs.  The  next  few  paragraphs  explain  how  this  is 
done. 

The  job  of  refreshing  the  dynamic  RAM  devices  is  minimized  by  the 
structure  of  the  devices  themselves.  The  individual  data  cells  in 
each  RAM  device  are  arranged  in  a  rectangular  array  of  rows  and 
columns.  When  the  device  is  addressed,  the  part  of  the  address  that 
specifies  a  row  is  presented  first,  followed  by  the  address  of  the 
column.  Splitting  information  into  parts  that  follow  each  other  in 
time  is  called  multiplexing.  Because  only  half  of  the  address  is 
needed  at  one  time,  multiplexing  the  address  reduces  the  number 
of  pins  needed  for  connecting  the  RAMs  (Figure  11-14). 
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Memory  expansion 


Table  11 

■12 

RAM  address  multiplexing 

Mux'd 

Row 

Column 

address 

address 

address 

RAO 

AO 

A9 

RAl 

Al 

A6 

RA2 

A2 

AlO 

RA3 

A3 

All 

RA4 

A4 

A12 

RA5 

A5 

A13 

RA6 

A7 

A14 

RA7 

A8 

A15 

In  the  Apple  lie  thiat  supports  the  memory  expansion  card,  the 
16  64Kxl  RAM  ICs  used  for  the  original  and  UnlDlsk  3.5  lie's  are 
replaced  by  4  64Kx4  ICs. 

Different  manufacturers'  64K  RAMs  have  cell  arrays  of  either 

128  rows  by  512  columns  or  256  rows  by  256  columns.  Only  the  row 

portion  of  the  address  is  used  in  refreshing  the  RAMs. 

Now  consider  how  the  display  is  refreshed.  As  described  later  in  this 
chapter,  the  display  circuitry  generates  a  sequence  of 
8,192  memory  addresses  in  high-resolution  mode;  in  text  and  low- 
resolution  modes,  this  sequence  is  the  1,024  display-page 
addresses  repeated  8  times.  The  display  address  cycles  through  this 
sequence  60  times  a  second,  or  once  every  17  milliseconds.  The 
way  the  low-order  address  lines  are  assigned  to  the  RAMs,  the  row 
address  cycles  through  all  256  possible  values  once  every  2 
milliseconds  (see  Table  11-12).  This  more  than  satisfies  the  refresh 
requirements  of  the  dynamic  RAMs. 


Dynamic  RAM  timing 

The  Apple  He's  microprocessor  clock  runs  at  a  speed  of  1.023  MHz, 
but  the  interleaving  of  CPU  and  display  cycles  means  that  the  RAM 
is  being  accessed  at  a  2-MHz  rate,  or  a  cycle  time  of  just  under 
500  nanoseconds.  Data  for  the  CPU  are  strobed  by  the  falling  edge 
of  00,  and  display  data  are  strobed  by  the  falling  edge  of  0I,  as 
shown  in  Figure  11-15. 

The  RAM  timing  looks  complicated  because  the  RAM  address  is 
multiplexed,  as  described  previously.  The  MMU  takes  care  of 
multiplexing  the  address  for  the  CPU  cycle,  and  the  lOU  performs 
the  same  function  for  the  display  cycle.  The  multiplexed  address  is 
sent  to  the  RAM  ICs  over  the  lines  RA0-RA7  (Table  11-13).  Along 
with  the  other  timing  signals,  the  TMG  generates  two  signals  that 
control  the  RAM  addressing:  row-address  strobe  (RAS)  and 
column-address  strobe  (CAS). 
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Table  11-13 

RAM  tinning  signais 

Signal 

Description 

00 

Clock  phase  0  (CPU  phase) 

01 

Clock  phase  1  (display  phase) 

RAS 

Row-address  strobe 

CAS 

Column-address  strobe 

Q3 

Alternate  RAM/column-address  strobe 

RA0-RA7 

Multiplexed  address  bus 

MD0-MD7 

Internal  data  bus 

14M 
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Figure  11-15 

I^AM  timing  signals 
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The  keyboard 

The  Apple  lie's  keyboard  is  a  matrix  of  key  switches  connected  to  an 
AY-3600-type  keyboard  decoder  via  a  ribbon  cable  and  a  26-pin 
connector  (Figure  11-16).  The  AY-36(X)  scans  the  array  of  keys  over 
and  over  to  detect  any  keys  pressed.  The  scanning  rate  is  set  by  the 
external  resistor-capacitor  network  made  up  of  C46  and  R6.  The 
debounce  time  is  also  set  externally,  by  C45. 
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Figure  11-16 

Keyboard  circuit  diagram 
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Figure  11-17 

Keyboard  signals 


The  AY-3600's  outputs  include  five  bits  of  key  code  plus  separate 
lines  for  Control,  Shift,  any-key-down,  and  keyboard  strobe.  The 
any-key-down  and  keyboard-strobe  lines  are  connected  to  the  lOU, 
which  addresses  them  as  soft  switches.  The  key-code  line  and 
Control  and  Shift  are  inputs  to  a  separate  2316  ROM.  The  ROM 
translates  them  to  the  character  codes  that  are  enabled  x)nto  the 
data  bus  by  signals  named  KBD*  and  ENKBD*.  The  KBD*  signal  is 
enabled  by  the  MMU  whenever  a  program  reads  location  $C000,  as 
described  in  Chapter  2. 

Figure  11-17  illustrates  the  events  that  occur  when  a  key  is  pressed, 
when  the  keypress  is  detected  by  a  program,  and  when  a  key  is 
pressed  and  held  for  more  than  about  a  second. 
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The  speaker 

The  Apple  He's  built-in  loudspeaker  is  controlled  by  a  single  bit  of 
output  from  the  input/output  unit  (lOU),  amplified  by  a  hybrid 
circuit  (Figure  11-18). 
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Figure  11-18 

Speaker  circuit  diagram 


AUD  is  an  audio-amplifier  hybrid 
circuit. 


Volume  control 

There  is  a  500-ohm  variable  resistor  feeding  anywhere  from  0  to 
5  volts  to  pin  5  of  AUD  to  control  the  speaiier  volume.  This 
potentiometer  controls  the  volume  of  both  the  built-in  speaker  and 
whatever  is  plugged  into  the  output  jack. 


Output  jack 

Next  to  the  volume  control,  along  the  lower-left  side  of  the  Apple  lie 
case,  there  is  a  3.5-mm  audio  output  jack.  Although  speaker  output 
is  monaural,  the  jack  accommodates  stereo  headphone  plugs  (as 
well  as  monaural),  providing  sound  to  both  channels.  Inserting  a 
headphone  plug  into  the  jack  disconnects  the  built-in  speaker. 
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The  video  display 

The  Apple  lie  produces  a  video  signal  that  creates  a  display  on  a 
standard  video  monitor  or,  if  you  add  an  RF  modulator,  on  a  black- 
and-white  or  color  television  set.  The  video  signal  is  a  composite 
made  up  of  the  data  that  are  being  displayed  plus  the  hori2ontal  and 
vertical  synchronization  signals  that  the  video  monitor  uses  to 
arrange  the  lines  of  display  data  on  the  screen. 

♦  Note:  Apple  lie  computers  manufactured  for  sale  in  the  USA 
generate  a  video  signal  that  is  compatible  with  the  standards  set 
by  the  NTSC  (National  Television  Standards  Committee). 
Apple  He's  used  in  European  countries  require  an  external 
adapter  to  provide  video  that  is  compatible  with  the  standard 
used  there,  which  is  called  PAL  (for  phase  alternating  lines). 
References  to  the  PAL  standard  are  found  in  the  bibliography  at 
the  end  of  this  manual.  This  manual  describes  only  the  NTSC 
version  of  the  video  circuits. 

The  display  portion  of  the  video  signal  is  a  time-varying  voltage 
generated  from  a  stream  of  data  bits,  where  a  1  corresponds  to  a 
voltage  that  generates  a  bright  dot,  and  a  0  to  a  dark  dot.  The 
display  bit  stream  is  generated  in  bursts  that  correspond  to  the 
horizontal  lines  of  dots  on  the  video  screen.  The  signal  named 
WNDW  is  low  during  these  bursts. 

During  the  time  intervals  between  bursts  of  data,  nothing  is 
displayed  on  the  screen.  During  these  intervals,  called  the 
blanking  intervals,  the  display  is  blank  and  the  WNDW*  signal  is 
high.  The  synchronization  signals,  called  sync  for  short,  are 
produced  by  making  the  signal  named  SYNC  low  during  portions 
of  the  blanking  intervals.  The  sync  pulses  are  at  a  voltage  equivalent 
to  blacker-than-black  video  and  don't  show  on  the  screen. 


The  video  counters 

The  address  and  timing  signals  that  control  the  generation  of  the 
video  display  are  all  derived  from  a  chain  of  counters  inside  the 
lOU.  Only  a  few  of  these  counter  signals  are  accessible  from  outside 
the  lOU,  but  they  are  all  important  in  understanding  the  operation 
of  the  display  generation  process,  particularly  the  display  memory 
addressing  described  in  the  next  section. 
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The  horizontal  counter  is  made  up  of  seven  stages:  HO,  HI, 
H2,  H3,  H4,  H5,  and  HPE*.  The  input  to  the  horizontal  counter  is 
the  l-MHz  signal  that  controls  the  reading  of  data  being  displayed. 
The  complete  cycle  of  the  horizontal  counter  consists  of  65  states. 
The  six  bits  HO  through  H5  count  from  0  to  64,  then  start  over  at  0. 
Whenever  this  happens,  HPE*  forces  another  count  with  HO 
through  H5  held  at  0,  extending  the  total  count  to  65. 

The  lOU  uses  the  40  horizontal  count  values  from  25  through  64  in 
generating  the  low-order  part  of  the  display  data  address.  The  lOU 
uses  the  count  values  from  0  to  24  to  generate  the  horizontal 
blanking,  the  horizontal  sync  pulse,  and  the  color-burst  gate. 

When  the  horizontal  count  gets  to  65,  it  signals  the  end  of  a  line  by 
triggering  the  vertical  counter.  The  vertical  counter  has  nine  stages: 
VA,  VB,  VC,  VO,  VI,  V2,  V3,  V4,  and  V5.  When  the  vertical  count 
reaches  262,  the  lOU  resets  it  and  starts  counting  again  from  0.  Only 
the  first  192  scanning  lines  are  actually  displayed;  the  lOU  uses  the 
vertical  counts  from  192  to  262  to  generate  the  vertical  blanking  and 
sync  pulse.  Nothing  is  displayed  during  the  vertical  blanking 
interval.  (The  vertical  line  count  is  262  rather  than  the 
standard  262.5  because,  unlike  normal  television,  the  Apple  He's 
video  display  is  not  interlaced.) 


Display  memory  addressing 

As  described  in  Chapter  5,  data  bytes  are  not  stored  in  memory  in 
the  same  sequence  in  which  they  appear  on  the  display.  You  can  get 
an  idea  of  the  way  the  display  data  are  stored  by  using  the  Monitor 
to  set  the  display  to  graphics  mode,  then  storing  data  starting  at  the 
beginning  of  the  display  page  at  hexadecimal  $0400  and  watching 
the  effect  on  the  display.  If  you  do  this,  you  should  use  the  graphics 
display  instead  of  text  to  avoid  confusion:  the  text  display  is  also 
used  for  Monitor  input  and  output. 

If  you  want  your  program  to  display  data  by  storing  them  directly 
into  the  display  memory,  you  must  first  transform  the  display 
coordinates  into  the  appropriate  memory  addresses,  as  shown  in 
Chapter  2.  The  descriptions  that  follow  will  help  you  understand 
how  this  address  transformation  is  done  and  why  it  is  necessary. 

The  address  transformation  that  folds  three  rows  of  40  display  bytes 
into  128  contiguous  memory  locations  is  the  same  for  all  display 
modes,  so  it  is  described  first.  The  differences  among  the  different 
display  modes  are  described  later  in  this  chapter. 
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The  requirements  for  RAM 
refreshing  are  discussed  earlier 
in  this  chapter  under  "!?AM 
addressing." 


Display  address  mapping 

Consider  the  simplest  display  on  the  Apple  lie,  the  40-column  text 
mode.  To  address  40  columns  requires  6  bits,  and  to  address  24 
rows  requires  another  5  bits,  for  a  total  of  1 1  address  bits. 
Addressing  the  display  this  way  would  involve  2048  (2  to  the  11th 
power)  bytes  of  memory  to  display  a  mere  960  characters.  The  80- 
column  text  mode  would  require  4096  bytes  to  display 
1920  characters.  The  leftover  chunks  of  memory  that  were  not 
displayed  could  be  used  for  storing  other  data,  but  not  easily, 
because  they  would  not  be  contiguous. 

Instead  of  using  the  horizontal  and  vertical  counts  to  address 
memory  directly,  the  circuitry  inside  the  lOU  transforms  them  into 
the  new  address  signals  described  below.  The  transformed  display 
address  must  meet  the  following  criteria: 

D  map  the  960  bytes  of  40-column  text  into  only  1024  bytes 

a  scan  the  low-order  address  to  refresh  the  dynamic  RAMs 

D  continue  to  refresh  the  RAMs  during  video  blanking 

The  transformation  involves  only  horizontal  counts  H3,  H4, 
and  H5,  and  vertical  counts  V3  and  V4.  Vertical  count  bits 
VA,  VB,  and  VC  address  the  lines  making  up  the  characters,  and 
are  not  involved  in  the  address  transformation.  The  remaining  low- 
order  count  bits,  HO,  HI,  H2,  VO,  VI,  and  V2  are  used  directly, 
and  are  not  involved  in  the  transformation. 

The  lOU  performs  an  addition  that  reduces  the  five  significant  count 
bits  to  four  new  signals  SO,  SI,  S2,  and  S3,  where  S  stands  for  sum. 
Figure  11-19  is  a  diagram  showing  the  addition  in  binary  form,  with 
V3  appearing  as  the  carry  in  and  H5  appearing  as  its 
complement  H5*.  A  constant  value  of  1  appears  as  the  low-order 
bit  of  the  addend.  The  carry  bit  generated  with  the  sum  is  not  used. 

If  this  transformation  seems  terribly  obscure,  try  it  with  actual 
values.  For  example,  for  the  upper-left  corner  of  the  display,  the 
vertical  count  is  0  and  the  horizontal  count  is  24:  HO,  HI,  H2, 
and  H5  are  O's,  and  H3  and  H4  are  I's.  The  value  of  the  sum  is  0,  so 
the  memory  location  for  the  first  character  on  the  display  is  the  first 
location  in  the  display  page,  as  you  might  expect. 
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Table  1M4 

Display  memory 
addressing 


Memory 
address  bit 


Display 
address  bit 


AO 

HO 

Al 

HI 

A2 

H2 

A3 

SO 

A4 

SI 

A5 

S2 

A6 

S3 

A7 

VO 

A8 

VI 

A9 

V2 

AlO 

All 

A10 

A13 

A14 

A15 

GND 

•  For  these  address  bits, 

see  Table  11-15. 

V3 

Carry  In 

H5*         V3 

H4 

H3 

Augend 

V4            H5* 

V4 

1 

Addend 

S3            82 

S1 

so 

Sum 

Figure  11-19 

Display  address  transformation 

Horizontal  bits  HO,  HI,  and  H2  and  sum  bits  SO,  SI,  and  S2  make 
up  the  transformed  horizontal  address  (AO  through  A6  in 
Table  11-14).  As  the  horizontal  count  increases  from  24  to  63,  the 
value  of  the  sum  (53  S2  51  50)  increases  from  0  to  4  and  the 
transformed  address  goes  from  0  to  39,  relative  to  the  beginning  of 
the  display  page. 

The  low-order  three  bits  of  the  vertical  row  counter  are  VO,  VI, 
and  V2.  These  bits  control  address  bits  A7,  A8,  and  A9,  as  shown 
in  Table  11-14,  so  that  rows  0  through  7  start  on  128-byte 
boundaries.  When  the  vertical  row  counter  reaches  8,  VO,  VI, 
and  V2  are  0  again,  and  V3  changes  to  1.  If  you  do  the  addition  in 
Figure  11-19  with  H  equal  to  24  (the  horizontal  count  for  the  first 
column  displayed)  and  V  equal  to  8,  the  sum  is  5  and  the  horizontal 
address  is  40:  the  first  character  in  row  8  is  stored  in  the  memory 
location  40  bytes  from  the  beginning  of  the  display  page. 

Table  11-14  shows  how  the  signals  from  the  video  counters  are 
assigned  to  the  address  lines.  HO,  HI,  and  H2  are  horizontal-count 
bits,  and  VO,  VI,  and  V2  are  vertical-count  bits.  SO,  SI,  S2,  and  53 
are  the  folded  address  bits  described  above.  Table  11-15  shows 
memory  address  bits  for  the  display  modes. 

Table  11-15 

Memory  address  bits  for  display  modes 


Address 
bit 


Text  and 
low  resolution 


High  resolution  and 
double  higti  resolution 


AlO 


80STORE+PAGE2' 


VA 


All 

80STORE'.PAGE2 

VB 

A12 

0 

VC 

A13 

0 

80STORE+PAGE2' 

A14 

0 

80STORE'.PAGE2 

Note:  Period  (.)  means  logical  AND;  prime  Q  means  logical  NOT. 
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Figure  1 1-20  shows  how  groups  of  three  40-character  rows  are  stored 
in  blocks  of  120  contiguous  bytes  starting  on  128-byte  address 
boundaries.  This  diagram  is  another  way  of  desaibing  the  display 
mapping  shown  in  Figure  5-5.  Notice  that  the  three  rows  in  each 
block  of  120  bytes  are  not  adjacent  on  the  display. 


8 
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$400 

RowO 

Row  8 

Row  16 
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Row  1 

Row  9 

Row  17 

.. 
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*  * 

$580 

Row  3 

Row  11 

Row  19 

*  * 

$600 

Row  4 

Row  12 

Row  20 

*  * 

$680 

Row  5 

Row  13 

Row  21 

.. 

$700 

Row  6 

Row  14 

Row  22 

*  * 

$780 

Row  7 

Row  15 

Row  23 

*  * 

Figure  11-20 

40-column  text  display  memory  (memory  locations  marked  with 
a  double  asterisk  **  are  screen  holes,  described  In  Chapter  2) 


Video  display  modes 

The  different  display  modes  all  use  the  address-mapping  scheme 
described  later  in  this  chapter,  but  they  use  different-sized  memory 
areas  in  different  locations.  This  section  describes  the  addressing 
schemes  and  the  methods  of  generating  the  actual  video  signals  for 
the  different  display  modes.  Figure  11-21  illustrates  the  video 
display  circuits  discussed  in  this  section. 
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Figure  11-21 

Video  display  circuits 
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Text  displays 

The  text  and  low-resolution  graphics  pages  begin  at  memory 
locations  $0400  and  $0800.  Table  11-15  shows  how  the  display- 
mode  signals  control  the  address  bits  to  produce  these  addresses. 
Address  bits  AlO  and  All  are  controlled  by  the  settings  of  Page2 
and  SOStore,  the  display-page  and  80-column-video  soft  switches. 
Address  bits  A12,  A13,  and  A14  are  set  to  0.  Notice  that  SOStore 
active  inhibits  Page2:  there  is  only  one  display  page  in  80-column 
mode. 

The  low-order  six  bits  of  each  data  byte  reach  the  character 
generator  directly,  via  the  video  data  bus  VID0-VID5.  The  two 
high-order  bits  are  modified  by  the  lOU  to  select  between  the 
primary  and  alternate  character  sets  and  are  sent  to  the  character 
generator  on  lines  RA9  and  RAIO. 

The  data  for  each  row  of  characters  are  read  eight  times,  once  for 
each  of  the  eight  lines  of  dots  making  up  the  row  of  characters.  The 
data  bits  are  sent  to  the  character  generator  along  with  VA,  VB, 
and  VC,  the  low-order  bits  from  the  vertical  counter.  For  each 
character  being  displayed,  the  character  generator  puts  out  one  of 
eight  stored  bit  patterns  selected  by  the  three-bit  number  made  up 
of  VA,  VB,  and  VC. 

The  bit  patterns  from  the  character  generator  are  loaded  into  the 
74166  parallel-to-serial  shift  register  and  output  as  a  serial  bit  stream 
that  goes  to  the  video  output  circuit  (Figure  11-21).  The  shift  register 
is  controlled  by  signals  named  LDPS*  (for  load  parallel-to-serial 
shifter)  and  VID7M  (for  video  7  MHz).  In  40-column  mode,  LDPS* 
strobes  the  output  of  the  character  generator  into  the  shift  register 
once  each  miaosecond,  and  VID7M  shifts  the  bits  out  at  7  MHz 
(Figure  11-22). 

The  addressing  for  the  80-column  display  is  exactly  the  same  as  for 
the  40-column  display:  the  40  columns  of  display  memory  in 
auxiliary  memory  are  addressed  in  parallel  with  the  40  columns  in 
main  memory.  The  data  from  these  two  memories  reach  the  video 
data  bus  Oines  VID0-VID7)  via  separate  74LS374  three-state  buffers. 
These  buffers  are  loaded  simultaneously  (at  the  rising  edge  of  0O), 
but  their  outputs  are  sent  to  the  character  generator  alternately  by 
the  falling  edge  of  0O  and  0I.  In  80-column  mode,  LDPS*  loads 
data  from  the  character  generator  into  the  shift  register  twice  during 
each  microsecond,  once  during  0O  and  once  during  0I,  and 
VID7M  remains  low,  enabling  the  clock  continuously  at  14M 
(Figure  11-23). 
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Figure  11-22 

7-MHz  video  timing  signals:  40-column,  low-resolution,  and  hlgti-resolution  display 
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Figure  1 1  -23 

14-MHz  video  tinning  signals:  80-column  and  double  high-resolution  display 
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Low-resolution  display 

In  the  graphics  modes,  VA  and.  VB  are  not  used  by  the  character 
generator,  so  the  lOU  uses  lines  SEGA  and  SEGB  to  transmit  HO  and 
HIRES*,  as  shown  in  Table  11-16. 

Table  11-16 

Character-generator  control  signals 

Display  mode       SEGA        SEGB  SEGC 

Text  VA  VB  VC 

Graphics  HO  HIRES*       VC 

The  low-resolution  graphics  display  uses  VC  to  divide  the  eight 
display  lines  corresponding  to  a  row  of  characters  into  two  groups 
of  four  lines  each.  Each  row  of  data  bytes  is  addressed  eight  times, 
the  same  as  in  text  mode,  but  each  byte  is  interpreted  as  two 
nibbles.  Each  nibble  selects  1  of  16  colors.  During  the  upper  four  of 
the  eight  display  lines,  VC  is  low  and  the  low-order  nibble 
determines  the  color.  During  the  lower  four  display  lines,  VC  is 
high  and  the  high-order  nibble  determines  the  color. 

The  bit  patterns  that  produce  the  low-resolution  colors  are  read 
from  the  character-generator  ROM  in  the  same  way  the  bit  patterns 
for  characters  are  produced  in  text  mode.  The  74166  parallel-to- 
serial  shift  register  converts  the  bit  patterns  to  a  serial  bit  stream  for 
the  video  circuits  (Figure  11-21). 

The  video  signal  generated  by  the  Apple  lie  includes  a  short  burst  of 
3.58-MHz  signal  that  is  used  by  an  NTSC  color  monitor  or  color 
TV  set  to  generate  a  reference  3.58-MHz  color  signal.  The 
Apple  He's  video  signal  produces  color  by  interacting  with  this 
3.58-MHz  signal  inside  the  monitor  or  TV  set.  Different  bit  patterns 
produce  different  colors  by  changing  the  duty  cycles  and  delays  of 
the  bit  stream  relative  to  the  3.58-MHz  color  signal.  To  produce  the 
small  delays  required  for  so  many  different  colors,  the  shift  register 
runs  at  14  MHz  and  shifts  out  14  bits  during  each  cycle  of  the  1-MHz 
data  dock.  To  generate  a  stream  of  14  bits  from  each  8-bit  pattern 
read  from  the  ROM,  the  output  of  the  shift  register  is  connected 
back  to  the  register's  serial  input  to  repeat  the  same  8  bits;  the  last  2 
bits  are  ignored  the  second  time  around. 
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Each  bit  pattern  is  output  for  the  same  amount  of  time  as  a 
character:  1.02  miaoseconds.  Because  that  is  exactly  enough  time 
for  three  and  a  half  cycles  of  the  3.58-MHz  color  signal,  the  phase 
relationship  between  the  bit  patterns  and  the  signal  changes  by  a 
half  cycle  for  each  successive  pattern.  To  compensate  for  this,  the 
character  generator  puts  out  one  of  two  different  bit  patterns  for 
each  nibble,  depending  on  the  state  of  HO,  the  low-order  bit  of  the 
horizontal  counter. 

High-resolution  display 

The  high-resolution  graphics  pages  begin  at  memory  locations 
$2000  and  $4000  (decimal  8192  and  16384).  These  page  addresses 
are  selected  by  address  bits  A13  and  A14.  In  high-resolution  mode, 
these  address  bits  are  controlled  by  PAGE2  and  80STORE,  the 
signals  controlled  by  the  display-page  CPage2)  and  80-column- 
video  (80Col)  soft  switches.  As  in  text  mode,  80STORE  inhibits 
addressing  of  the  second  page  because  there  is  only  one  page  of  80- 
column  text  available  for  mixed  mode. 

In  high-resolution  graphics  mode,  the  display  data  are  still  stored 
in  blocks  like  the  one  shown  in  Figure  11-20,  but  there  are  eight  of 
these  blocks.  As  Tables  11-14  and  11-15  show,  vertical  counts 
VA,  VB,  and  VC  are  used  for  address  bits  AlO,  All,  and  A12, 
which  address  eight  blocks  of  1024  bytes  each.  Remember  that  in 
the  display,  VA,  VB,  and  VC  count  adjacent  horizontal  lines  in 
groups  of  eight.  This  addressing  scheme  maps  each  of  those  lines 
into  a  different  1024-byte  block. 

It  might  help  to  think  of  this  scheme  as  a  kind  of  eight-way 
multiplexer:  it's  as  if  eight  text  displays  were  combined  to  produce  a 
single  high-resolution  display,  with  each  text  display  providing  one 
line  of  dots  in  turn,  instead  of  a  row  of  characters. 

The  high-resolution  bit  patterns  are  produced  by  the  character- 
generator  ROM.  In  this  mode,  the  bit  patterns  simply  reproduce  the 
seven  bits  of  display  data.  The  low-order  six  bits  of  data  reach  the 
ROM  via  the  video  data  bus  VID0-ViD5.  The  lOU  sends  the  other 
two  data  bits  to  the  ROM  via  RA9  and  RAIO. 
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The  high-resolution  colors  described  in  Chapter  2  are  produced  by 
the  interaction  between  the  video  signal  the  bit  patterns  generate 
and  the  3.58-MHz  color  signal  generated  inside  the  monitor  or 
TV  set.  The  high-resolution  bit  patterns  are  always  shifted  out  at 
7  MHz,  so  each  dot  corresponds  to  a  half-cycle  of  the  3.58-MHz 
color  signal.  Any  part  of  the  video  signal  that  produces  a  single 
white  dot  between  two  black  dots,  or  vice  versa,  is  effectively  a  short 
burst  of  3.58  MHz  and  is  therefore  displayed  as  color.  In  other 
words,  a  bit  pattern  consisting  of  alternating  I's  and  O's  gets 
displayed  as  a  line  of  color.  The  high-resolution  graphics 
subroutines  produce  the  appropriate  bit  patterns  by  masking  the 
data  bits  with  alternating  I's  and  O's. 

To  produce  different  colors,  the  bit  patterns  must  have  different 
phase  relationships  to  the  3.58-MHz  color  signal.  If  alternating  Is 
and  O's  produce  a  certain  color,  say  green,  then  reversing  the 
pattern  to  O's  and  I's  will  produce  the  complementary  color, 
purple.  As  in  the  low-resolution  mode,  each  bit  pattern 
corresponds  to  three  and  a  half  cycles  of  the  color  signal,  so  the 
phase  relationship  between  the  data  bits  and  the  color  signal 
changes  by  a  half  cycle  for  each  successive  byte  of  data.  Here, 
however,  the  bit  patterns  produced  by  the  hardware  are  the  same 
for  adjacent  bytes;  the  color  compensation  is  performed  by  the 
high-resolution  software,  which  uses  different  color  masks  for  data 
being  displayed  in  even  and  odd  columns. 

To  produce  other  colors,  bit  patterns  must  have  other  timing 
relationships  to  the  3.58-MHz  color  signal.  In  high-resolution 
mode,  the  Apple  lie  produces  two  more  colors  by  delaying  the 
output  of  the  shift  register  by  half  a  dot  (70  ns),  depending  on  the 
high-order  bit  of  the  data  byte  being  displayed.  (The  high-order  bit 
doesn't  actually  get  displayed  as  a  dot,  because  at  7  MHz  there  is 
only  time  to  shift  out  seven  of  the  eight  bits.) 

As  each  byte  of  data  is  sent  from  the  character  generator  to  the  shift 
register,  high-order  data  bit  D7  is  also  sent  to  the  TMG.  If  D7  is  off, 
the  TMG  transmits  shift-register  timing  signals  LDPS*  and  VID7M 
normally.  If  D7  is  on,  the  TMG  delays  LDPS*  and  VID7M  by 
70  nanoseconds,  the  time  corresponding  to  half  a  dot.  The  bit 
pattern  that  formerly  produced  green  now  produces  orange;  the 
pattern  for  purple  now  produces  blue. 

♦  A  note  about  timing:  For  80-column  text,  the  shift  register  is 
clocked  at  twice  normal  speed.  When  80-column  text  is  used 
with  graphics  in  mixed  mode,  the  TMG  controls  shift-register 
timing  signals  LDPS*  and  VID7M  so  that  the  graphics  portion 
of  the  display  works  correctly  even  when  the  text  window  is  in 
80-column  mode. 
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RGB  stands  for  red,  green,  and 
blue,  and  identifies  a  type  of 
color  monitor  thot  uses 
independent  Inputs  for  the  ttiree 
primary  colors. 


For  furttier  information  about 
double  tiigh-resoiution  graphics 
display,  refer  to  the  Bibliography. 


Double  high -resolution  display 

Double  high-resolution  graphics  mode  displays  two  bytes  in  the 
time  normally  required  for  one,  but  it  uses  high-resolution  graphics 
Pages  1  and  IX  instead  of  text  and  low-resolution  Pages  1  and  IX. 

♦  Note:  There  is  a  second  pair  of  bytes,  HRP2  and  HRP2X,  which 
can  be  used  to  display  a  second  double  high-resolution  page. 

Double  high-resolution  graphics  mode  displays  each  pair  of  data 
bytes  as  14  adjacent  dots,  7  from  each  byte.  The  high-order  bit 
(color-select  bit)  of  each  byte  is  ignored.  The  auxiliary-memory 
byte  is  displayed  first,  so  data  from  auxiliary  memory  appear  in 
columns  0-6,  14-20,  and  so  on,  up  to  columns  547-552.  Data  from 
main  memory  appear  in  columns  7-13,  21-27,  and  so  on,  up 
to  553-559. 

As  in  80-column  text,  there  are  twice  as  many  dots  across  the 
display  screen,  so  the  dots  are  only  half  as  wide.  On  a  TV  set  or  low- 
bandwidth  Oess  than  14  MHz)  monitor,  single  dots  are  dimmer 
than  normal. 

♦  Note:  Except  for  some  expensive  RGB-type  color  monitors, 
any  video  monitor  with  a  bandwidth  as  high  as  14  MHz  will  be  a 
monochrome  monitor.  Monochrome  means  one  color:  a 
monochrome  video  monitor  can  have  a  screen  color  of  white, 
green,  orange,  or  any  other  single  color. 

The  main  memory  and  auxiliary  memory  are  connected  to  the 
address  bus  in  parallel,  so  both  are  activated  during  the  display 
cycle.  The  rising  edge  of  0O  clocks  a  byte  of  main  memory  data  into 
the  video  latch,  and  a  byte  of  auxiliary  memory  data  into  the 
80  latch  (Figure  11-21). 

Phi  1  enables  output  from  the  (auxiliary)  80  latch,  and  0O  enables 
output  from  the  (main)  video  latch.  Output  from  both  latches  goes 
to  CHARGEN,  where  GR  and  SEGB*  select  high-resolution 
graphics.  LDPS  operates  at  2  MHz  in  this  mode,  alternately  gating 
the  auxiliary  byte  and  main  byte  into  the  parallel-to-serial  shift 
register.  VID7M  is  active  (kept  true)  for  double  high-resolution 
display  mode,  so  when  it  is  ANDed  with  14M,  the  result  is  still  14M. 
The  14M  serial  clock  signal  gates  shift  register  output  to  VID,  the 
video  display  hybrid  circuit,  for  output  to  the  display  device. 
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VID  Is  a  vldeo-ampllfler  hybrid 
circuit. 


Video  output  signals 

The  stream  of  video  data  generated  by  the  display  circuits  described 
above  goes  to  a  hybrid  circuit  (VID)  that  adjusts  the  signals  to  the 
proper  amplitudes  and  conditions  the  color  burst. 

The  resulting  video  signal  is  an  NTSC-compatible  composite-video 
signal  that  can  be  displayed  on  a  standard  video  monitor.  The 
signal  is  similar  to  the  EIA  (Electronic  Industries  Association) 
standard  positive  composite  video.  This  signal  is  available  in  two 
places  in  the  Apple  lie  (Figure  11-24): 

n  at  the  video  output  connector  on  the  back  of  the  Apple  lie 

n  at  the  video  expansion  connector  (pin  12)  on  the  back  panel 
(Table  11-17) 


Monitor  output 

The  sleeve  of  the  video  output  connector  at  the  center  of  the 
Apple  lie  back  panel  is  connected  to  ground  and  the  tip  is 
connected  to  the  video  output  through  a  resistor  network  that 
attenuates  it  to  about  1  volt  and  matches  its  impedance  to  75  ohms. 
This  arrangement  is  suitable  for  most  video  monitors. 


m\  !□! 


pGND 


VIDOUT 


Back  Panel 


Video  Video  Output  Connector 

Expansion  Connector         (For  a  Monitor) 
(For  an  RF  Modulator 
or  Special  Adaptor) 
(See  Fig.  11-25) 


Figure  11-24 

Video  output  back  panel  connectors 
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Video  expansion  output 

The  back  panel  of  the  Apple  lie  has  a  DB-15  connector  for 
sophisticated  video  interfaces  external  to  the  computer. 
Figure  11-25  shows  the  pin  assignments  for  this  connector; 
Table  11-17  describes  the  signals.  In  Table  11-17,  the  column 
labeled  Deriv  indicates  what  dock  signals  the  video  signals  are 
derived  from.  LDPS,  CREF,  and  PRAS  have  a  maximum  delay  of 
30  ns  from  the  appropriate  14-MHz  rising  edge.  SEROUT  is  clocked 
out  of  a  74LS166  by  the  rising  edge  of  14M  and  has  a  maximum  delay 
of  35  ns.  VIDD7  is  driven  from  a  74LS374  and  has  a  maximum  delay 
of  28  ns  from  the  rising  and  (if  80-column)  falling  edges  of  0I. 

To  align  CREF  so  it  is  in  the  same  phase  at  the  begiiming  of  every 
line,  certain  clock  signals  must  be  stretched.  This  stretch  is  for  one 
7M  cycle  (140  ns),  and  occurs  at  the  end  of  each  video  line.  All 
timing  signals  except  14M,  7M,  and  CREF  are  stretched. 


Warning      The  maximunn  allowable  current  drain  of  +12V  regulated  power 
at  the  video  expansion  connector  Is  300  miiliamps.  If  the 
external  device  draws  more  then  this,  It  can  damage  the 
computer  or  cause  the  power  supply  to  shut  down. 


Warning  The  signals  at  the  DB-15  on  the  Apple  lie  are  not  the  same  as 
those  at  the  DB-15  on  the  Apple  III.  Do  not  attempt  to  plug  a 
cable  Intended  for  one  into  the  other. 

Several  of  these  signals,  such  as  14  MHz,  must  be  buffered  within 
about  4  inches  (10  cm)  of  the  back  panel  connector— 
preferably  Inside  a  container  directly  connected  to  the  back 
panel.  For  technical  information,  contact  Apple  Technical 
Support, 
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Pin        Signal 

Pin 

Signal 

1           TEXT 

9 

PRAS* 

2           14M 

10 

GR 

3           SYNC* 

11 

SEROUT* 

4          SEGB 

12 

NTSC 

5          IVSOUND 

13 

GND 

6          LDPS* 

14 

VIDD7 

7          WNDW* 

15 

GREF 

8          +12V 

Figure  11-25 

Video  expansion  connector  pinouts 

Table  11-17 

Video  expansion  connector  signais 


Pin 


Deriv 


Signal 


Description 


00 


Q3 


TEXT 

14M 
SYNC* 


PRAS        SEGB 


5 

IVSOUND 

6 

14M 

LDPS* 

7 

PRAS 

WNDW* 

Video  text  signal  from  TMG;  set  to 
inverse  of  GR,  except  in  double 
high-resolution  mode 

14-MHz  master  timing  signal  from 
the  system  oscillator 

Displays  horizontal  and  vertical 
synchronization  signal  from  lOU 
pin  39 

Displays  vertical  counter  bit  from 
lOU  pin  4;  in  text  mode  indicates 
second  low-order  vertical 
counter;  in  graphics  mode 
indicates  low-resolution 

One-volt  sound  signal  from  pin  5 
of  the  audio  hybrid  circuit  (AUD) 

Video  shift-register  load  enable 
from  pin  12  of  TMG 

Active  area  display  blanking; 
includes  both  horizontal  and 
vertical  blanking 
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Table  11-17  (continued) 

Video  expansion  connector  signals 


Pin 

Derlv 

Signal 

Description 

8 

+12V 

Regulated  +12  volts  DC;  can  drive 
300  mA 

9 

14M 

PRAS* 

RAM  row-address  strobe  from 
TMG  pin  19 

10 

PRAS 

GR 

Graphics  mode  enable  from  lOU 
pin  2 

11 

14M 

SEROUT* 

Serialized  character-generator 

12 


NTSC 


output  from  pin  1  of  the  74LS166 
shift  register 

Composite  NTSC  video  signal 
from  VXD  hybrid  chip 


13 

GND 

Ground  reference  and  supply 

14 

00 

VIDD7 

From  74LS374  video  latch;  causes 
half-dot  shift  if  high 

15 

14M 

CREF 

Color  reference  signal  from  TMG 
pin  3;  3.58  MHz 

Disk  I/O 

Disk  I/O — for  both  the  built-in  and  the  external  drive — is  supported 
by  the  IWM  disk  controller  unit.  The  external  drive  is  attached  via  a 
DB-19  connector.  Figure  11-26  shows  this  connector.  Table  11-18 
describes  the  pin  assignments.  Supply  voltages  come  from  the 
power  supply;  all  other  signals  come  from  the  IWM,  described 
earlier  in  this  chapter. 


Warning     The  power  available  at  this  connector  is  for  a  Disk  lie  or  similar 
drive  only.  Do  not  use  power  from  the  external  disk  connector 
for  any  other  purpose— you  may  damage  the  internal  voltage 
converter.  To  derive  external  power  for  an  attached  device, 
use  one  of  the  other  connectors  and  observe  the  current  limits 
given  in  this  manual. 
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10     987654321 
•      ••••••••• 

19   18  17   16  15   14  13  12  11 
•     •••••••• 


Pin 


Signal 


Pin       Signal 


1,2,3,4  GND 

13 

SEEKPH2 

5          -12V 

14 

SEEKPH3 

6          +5V 

15 

WRREQ* 

7,8        +12V 

16 

N.C. 

9          EXTINT* 

17 

DR2* 

10          WRPROT 

18 

RDDATA 

11          SEEKPHO 

19 

WRDATA 

12          SEEKPHl 

Figure  11-26 

Disk  drive  connector 

Table  11-18 

Disk  drive  connector  signais 

Connector 
pin 


Signal 


Description 


1,2,3.4 

GND 

Ground  reference  and  supply 

6 

+5V 

+5  volt  supply 

7,8 

+12 

+12  volt  supply 

9 

EXTINT* 

External  interrupt 

10 

\(mPROT 

Write-protect  input 

11-14 

00-4 

Motor  phase  0-4  output 

15 

WRREQ* 

Write  request 

17 

DRl* 

Drive  1  select 

18 

RDDATA 

Read  data  input 

19 

WRDATA 

Write  data  output 

Serial  I/O 

The  Apple  lie  has  built  into  it  two  6551  asynchronous 
communication  interface  adapters  (ACIA)  and  supporting  input 
and  output  buffers  for  full-duplex  serial  communication. 
Figure  11-27  is  a  block  diagram  of  the  Apple  lie  serial  ports,  ACIA 
outputs  are  buffered  by  a  1448-quad  line  driver.  Similarly,  ACIA 
inputs  are  buffered  by  a  1489-quad  line  receiver. 
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Figure  11-27 

Serial  port  circuits 
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Figure  11-28  is  a  detailed  block  diagram  of  the  6551  ACIA.  The 
registers  are  described  later  in  this  chapter. 


00 

R/w* 

CSo 

cs/ 

RSo 

RS, 

RES* 


Select 

and 

Control 

Logic 

V 


^ 


:> 


Figure  11-28 

6551  ACIA  block  diagram  (copyright  i 
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Transmit 
Control 


Transmit 

Shift 
Register 


Interrupt 
Logic 
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Generator 
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Shift 
Register 


Receive 
Control 


CTS* 


-»-  TxD 


■*-    IRQ* 

—  DCD* 

—  DSR* 


■*-  RxC 

—  XTAL1 

—  XTAL2 


RxD 


■*■   DTR* 
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1978  by  Synertek  Inc.;  used  by  permission) 


The  6551  pin  assignments  are  shown  in  Figure  11-29  and  described 
in  Table  11-19.  Note  that  the  two  6551 's  are  not  used  in  exactly  the 
same  way — each  one  supports  a  different  set  of  interrupts. 

Port  1  reads  external  interrupts  (EXTINT*)  on  its  Data  Set  Ready 
(DSR)  pin.  This  input  is  tied  to  +5V  through  a  3.3-Kfl  pullup 
resistor. 
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GND 

1^ 

28 

A5 

2 

27 

SER* 

3 

26 

RESET* 

4 

25 

(N.C.) 

5 

24 

BCLK 

6 

23 

(N.C.) 

7 

22 

RTS* 

8 

21 

CTS* 

9 

20 

TxD 

10 

19 

(N.C.) 

11 

18 

RxD 

12 

17 

AO 

13 

16 

A1 

14 

15 

Figure  11-29 

6551  plnouts 


R/w* 

00 

IRQ* 

D7 

D6 

D5 

D4 

D3 

D2 

D1 

DO 

DSR* 

DCD* 

+  5V 


Table  n -19 

6551  signal  descriptions 


Pin 


Signal 


Description 


2 

A4 

A5 

3 

SER* 

4 

RESET* 

5 

N.C. 

6 

BCLK 

7 

N.C. 

8 

RTS* 

9 

CTS* 

10 

TXD 

11 

N.C. 

12 

RXD 

13,14 

AO.Al 

15 

+5V 

16 

DSR 

17 

EXTINT 

KSTRB 

18-25 

D0-D7 

26 

IRQ* 

27 

00 

28 

R/W 

Power  and  signal  common  ground 

Address  line  4  to  select  serial  port  1 
Address  line  5  to  select  serial  port  2 

Serial  device  select  from  GLU 

Resets  both  serial  ports 

Not  connected 

Baud  rate  clock  from  GLU 

Not  connected 

Request  to  Send  output 

Clear  to  Send  input  (not  used  on  IIc;  tied  to 
ground) 

Transmit  Data  output 

Not  connected 

Receive  Data  input 

Address  lines  0  and  1 

+5  volt  supply 

DCD*  pin;  used  on  lie  as  Data  Set  Ready 
input 

DSR'pin;  used  on  IIc  as 
External  interrupt  (port  1  ACLA),  or 
Keyboard  strobe  input  (port  2  ACLA.; 
Appendix  E) 

8-bit  data  bus 

Interrupt  Request  input 

Phase  0  clock  pulse 

Read/write  select  input 
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Port  1        Port  2 


1 

DTRIB 

DTR2B 

2 

TDIB 

TD2B 

3 

GND 

GND 

4 

RDIB 

RD2B 

5 

DSRIB 

DSR2B 

Figure  11-30 

Serial  port  connectors 


The  back  panel  connectors  for  both  serial  ports  are  5-pin  DIN  jacks. 
The  pin  assignments  are  shown  in  Figure  11-30  and  described  in 
Table  11-20. 

Table  11-20 

Serial  port  connector  signals 


Pin 

Signal 

Description 

1 

DTRIB 
DTR2B 

Data  Terminal  Ready  output 

2 

TDIB 
TD2B 

Transmit  Data  output 

3 

GND 

Power  and  signal  common 

4 

RDIB 
RD2B 

Read  Data  input 

5 

DSRIB 
DSR2B 

Data  Set  Ready  input 

ACIA  control  register 

Figure  11-31  shows  the  bit  assignments  for  the  ACIA  control 
register,  which  the  hardware  locates  at  address  $C09B  for  serial 
port  1,  and  $C0AB  for  serial  port  2.  This  register  determines  the 
number  of  data  and  stop  bits  the  ACIA  will  transmit  and  receive, 
and  the  clock  source  and  baud  rate  to  use  for  data  transfer. 

The  receiver  clock  source  is  derived  from  the  Apple  He's  TMG  chip; 
the  resulting  baud  rates  are  equal  to  or  up  to  two  percent  lower  than 
the  nominal  rate.  (The  EIA  standard  allows  plus  or  minus  two 
percent  variation.)  If  an  Apple  lie  serial  port  is  used  with  a  modem 
that  is  two  percent  above  the  nominal  rate,  framing  errors  can 
occur,  especially  at  1200  baud  and  above,  when  using  8  data  bits.  It 
may  be  necessary  to  select  a  lower  baud  rate  for  8-bit  binary  data 
transfers. 
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stop  Bits 


0  =   1  stop  bit 

1=2  stop  bits 

1  stop  bit  if  word  iength 
=  8  bits  and  parity** 
1'/!  stop  bits  if  word  iength 
=  5  bits  and  no  parity 


Word  Lengtii  • 


Bit 

Data  Word 
Length 

6 

5 

0 

0 

8 

0 

1 

7 

1 

0 

6 

1 

1 

5 

Receiver  Ciocl<  Source  ■ 


0  =  External  receiver  clocl< 

1  =  Baud  rate  generator 


**Thls  allows  for  9-bit  transmission  (8  data  plus  parity). 


Hardware  Reset 
Program  Reset 


Port  1  =  $C09B 
Port  2  =  $COAB 
Control  Register 


7 

6 

5 

4 

3 

2 

1 

0 

0 

0 

0 

0 

0 

0 

0 

0 

- 

- 

- 

- 

- 

- 

- 

- 

Baud  Rate  Generator 


16x  External  Clock 


50    baud 


75 


109.92 


134.58 


150 


300 


600 


1200 


1800 


2400 


3600 


4800 


7200 


9600 


19200 


Figure  11-31 

ACIA  control  register  (copyright  ©  1978  by  Synertek  Inc.;  used  by  permission) 


Seriai  I/O 


279 


ACIA  command  register 

Figure  11-32  shows  the  bit  assignments  for  the  ACIA  command 
register,  which  the  hardware  locates  at  address  $C09A  for  serial 
port  1,  and  at  $COAA  for  serial  port  2.  This  register  controls 
specific  transmit  and  receive  functions:  parity  checking,  echoing 
input  to  output,  allowing  transmit  and  receive  interrupts,  and 
setting  levels  for  Data  Terminal  Ready  and  Request  to  Send. 


Parity  Check  Controls  . 


Port  1  =  $C09A 

Port  2  =  $COAA 

Command  Register 


Bit 

Operation 

7 

6 

6 

- 

- 

0 

Parity  disabled— no  parity  bit 
generated,  no  parity  bit  received 

0 

0 

1 

Odd  parity  received  and  transmitted 

0 

1 

1 

Even  parity  received  and  transmitted 

1 

0 

1 

IVIARK  parity  bit  transmitted; 
received  parity  check  disabled 

1 

1 

1 

SPACE  parity  bit  transmitted; 
received  parity  check  disabled 

Normal  Echo  Mode 
for  Receiver  


0  =  Normal 

1  =  Echo  (bits  2  and  3  must  be  zero) 


Hardware  Reset 
Program  Reset 


.  Data  Terminal  Ready 


0  = 

Disable  receiver  and  all 

Interrupts  (DTR*  high) 

1  = 

Enable  receiver  and  all 

Interrupts  (DTR*  low) 

Receiver  Interrupt  Enable 


0  =  IRQ*  Interrupt  enabled  from  bit  3 

of  status  register 

1  =  IRQ*  interrupt  disabled 


.  Transmitter  Controls 


Bit 

Transmit 
Interrupt 

RTS* 
Level 

Transmitter 

3 

2 

0 

0 

Disabled 

High 

Off 

0 

1 

Enabled 

Low 

On 

1 

0 

Disabled 

Low 

On 

1 

1 

Disabled 

Low 

Transmit  BRK 

7 

6 

5 

4 

3 

2 

1 

0 

0 

0 

0 

0 
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0 

0 
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- 

0 

0 

0 

0 

0 

Figure  11-32 

ACIA  command  register  (copyright  ©  1978  by  Synertek  Inc.;  used  by  permission) 
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ACIA  status  register 

Figure  1 1-33  shows  the  bit  assignments  for  the  ACIA  status  register, 
which  is  hard-wired  to  address  $C099  for  serial  port  1,  and  $C0A9 
for  serial  port  2.  This  register  reports  the  condition  of  the 
transmit/receive  register,  errors  detected  during  data  transfer,  and 
the  level  of  the  Data  Carrier  Detect,  Data  Set  Ready,  and  Interrupt 
Request  lines. 


7 

6 

5 

4 

3 

2 

1 

0 

Port  1  =  $C099 
Port  2  =  $C0A9 


Status 

Set  By 

Cleared  By 

Parity  errort 

0  =  No  error 

1  =  Error 

Self-clearing** 

Framing  errort 

0  =  No  error 

1  =  Error 

Self-clearing** 

Overrunt 

0  =  No  error 

1  =  Error 

Self-clearing** 

Receive  Data, 
Register  full 

0  =  Not  full 

1  =  Full 

Reading  receive 
data  register 

Transmit  Data, 
Register  empty 

0  =  Not  empty 

1  =  Empty 

Writing  to  transmit 
data  register 

DCD* 

0  =  DCD*  low 

1  =  DCD*  high 

Not  resettable; 
reflects  DCD* 
state 

DSR* 

0  =  DSR*  low 

1  =  DSR*  high 

Not  resettable; 
reflects  DSR* 
state 

IRQ 

0  =  No  interrupt 

1  =  Interrupt 

Reading  status 
register 

t  No  interrupt  generated  for  these  conditions. 
*  *  Cleared  automatically  after  a  read  of  RDR 
and  the  next  error-free  receipt  of  data. 
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0 

Hardware  Reset 
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0 
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0 

0 

Program  Reset 

- 

- 
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- 

Figure  1 1  -33 

ACIA  status  register  (copyright 
used  by  permission) 


1978  by  Synertek  inc. 
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ACIA  transmit/receive  register 

Each  ACIA  uses  the  same  address— $C098  for  serial  port  1,  $C0A8 
for  serial  port  2 — as  temporary  storage  for  both  transmission  and 
reception  of  data. 

When  the  register  is  used  for  transmitting  data,  bit  0  is  the  leading 
bit  to  be  transmitted;  unused  data  bits  are  the  high-order  bits, 
which  are  ignored. 

When  the  register  is  used  for  receiving  data,  bit  0  is  the  first  bit 
received;  unused  data  bits  are  the  high-order  bits,  which  are  set 
to  0.  Parity  bits  never  appear  in  the  receive  data  register;  they  are 
stripped  off  after  being  used  for  external  parity  checking. 


Mouse  input 

The  mouse  is  a  hand-held  X-Y  pointing  device  that  can  be  rolled 
along  a  flat  surface.  It  has  an  attached  pushbutton.  This  section 
describes  how  mouse  movement  and  direction  can  be  detected  and 
interpreted. 

A  mouse  has  a  ball  inside  its  housing  that  protrudes  a  small  distance 
so  that  its  turning  corresponds  to  mouse  movements  across  a  table 
top.  Two  wheels  inside  the  housing,  set  at  90-degree  angles  to  each 
other,  follow  movements  of  the  ball;  this  causes  two  disks  to  rotate. 
The  disks  have  rectangular  holes  arranged  near  their  edges,  making 
them  resemble  circular  slide  mounts  used  with  stereoscopic  slide 
viewers. 

The  light  from  a  tiny  infrared  emitter  reaches  a  photoreceptor 
whenever  one  of  the  holes  on  the  disk  lies  between  them.  An 
internal  circuit  in  the  mouse  causes  the  resulting  voltage  to  swing 
quickly  to  a  1  or  a  0  value  as  soon  as  a  certain  threshold  is  crossed. 
The  result  is  something  approximating  a  square  wave  (Figure  11-34) 
that  varies  directly  with  the  speed  of  mouse  movement.  One  of 
these  indicates  the  X  component  (XO)  of  mouse  movement;  the 
other,  the  Y  component  CYO). 
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Movement 
Waveform 


_r^^^F^A^u^ 


Mouse 
Speed 

Figure  11-34 

Sample  mouse  waveform 

Under  program  control,  either  the  rising  edge  or  the  falling  edge  of 
each  square  wave  can  cause  an  interrupt,  which  the  firmware 
handles  by  updating  a  counter.  However,  the  program  needs  to 
know  whether  to  add  or  to  subtract  1  from  a  counter;  that  is,  it  needs 
to  know  the  direction  of  X  or  Y  movement. 

There  is  a  second  infrared  emitter/photoreceptor  pair  almost 
180  degrees  opposite  the  first  pair  for  each  disk.  These  pairs  are 
positioned  in  such  a  way  that  the  square  waves  they  generate  are 
approximately  a  quarter-wave  offset  from  their  respective 
movement  waves  (Figure  11-35).  These  waveforms  are  called 
XI  (X  direction)  and  Yl  (Y  direction). 
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Figure  11-35 

Mouse  movement  and  direction  waveforms 
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Pin 

Signal 

1 

MOUSEID* 

2 

+5V 

3 

GND 

4 

XDIR 

5 

XMOVE 

6 

(N.C.) 

7 

MSW* 

8 

YDIR 

9 

YMOVE 

Figure  11-36 

Mouse  connector 

When  a  rising  edge  of  XO  causes  an  intermpt,  a  mouse-driver 
program  can  immediately  check  whether  XI  is  0  (indicating  a 
movement  to  the  right)  or  1  (indicating  a  movement  to  the  left). 
Similarly,  the  mouse  driver  can  read  Yl  immediately  after  a 
YO  interrupt  to  determine  whether  the  mouse  moved  up  or  down 
one  count  along  the  Y  axis. 

Figure  1 1-36  shows  the  pin  assignments  for  the  mouse  DB-9 
connector  on  the  back  panel.  Table  11-21  gives  the  signal  names 
and  descriptions. 

Table  11-21 

Mouse  connector  signals 


Pin 

1 


Signai 


Description 


MOUSEID*       Mouse  identifier:  when  active,  disables 
NE556  hand  controller  timer 

+5V  Total  current  drain  from  this  pin  must  not 

exceed  100  mA 


3 

GND 

System  ground 

4 

XDIR 

Mouse  X-direction  indicator 

5 

XMOVE 

Mouse  X-movement  interrupt 

6 

N.C. 

Not  connected 

7 

MSW* 

Mouse  button 

8 

YDIR 

Mouse  Y-direction  indicator 

9 

YMOVE 

Mouse  Y-movement  interrupt 

Figure  11-37  shows  the  mouse  and  hand  controller  circuitry  with  the 
mouse  circuits  emphasized.  Figure  1 1-38  illustrates  the  values  of  the 
mouse-button  circuit  when  the  button  is  pressed  or  not  pressed. 
Pressing  the  button  disables  the  NE556  by  pulling  the  reset 
comparator  threshold  value  up  so  that  it  cannot  reset  the  flip  flop. 
As  a  result  the  mouse-button  input  value  remains  at  a  TTL  level. 
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Mouse  circuits 
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Input  Current  25 
(mA) 


IJtidHfined  (5V,21.4mA) 


(4.3V,6.2mA) 


Input  Voltage 
(Volts) 


-29.2mA) 
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(5V,  14.3mA) 


Input  Voltage 
(Volts) 


(2.9V,0mA) 
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Figure  11-38 

Mouse  button  signals 
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r 
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\ 
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\ 
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V 
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Pin 

Signal 

1 

GAMESWl 

2 

+5V 

3 

GND 

4 

Not  used  for  hand  controllers 

5 

PDLO 

6 

(N.C.) 

7 

GAMESWO 

8 

PDLl 

9 

Not  used  for  hand  controllers 

Figure  11-39 

Hand  controller  connector 

Hand  controller  input 

Several  input  signals  that  are  individually  controlled  via  soft 
switches  are  collectively  referred  to  as  the  hand  controller  (game) 
signals.  These  signals  arrive  in  the  Apple  lie  via  the  same  DB-9 
connector  as  the  one  used  for  the  mouse,  but  the  Apple  lie 
interprets  these  signals  differently. 

The  DB-9  connector  pin  assignments  and  signal  descriptions,  as 
used  for  hand  controller  input,  appear  in  Figure  11-39  and 
Table  11-22. 

Even  though  they  are  normally  used  for  hand  controllers,  these 
signals  can  be  used  for  other  simple  I/O  applications.  There  are  two 
1-bit  switch  inputs,  labeled  SwO  and  Swl,  and  two  analog  inputs, 
called  paddles  and  labeled  PdlO  and  Pdll.  Figure  11-40  shows  how 
to  connect  the  1-bit  switch  inputs  for  compatibility  with  all  other 
Apple  II  series  computers. 

The  switch  inputs  are  multiplexed  by  a  74LS251  8-to-l  multiplexer 
enabled  by  the  C06X*  signal  from  the  MMU.  Depending  on  the 
low-order  address,  the  appropriate  game  input  is  connected  to  bit  7 
of  the  data  bus.  Figure  11-41  shows  the  mouse  and  hand  controller 
circuitry  with  the  hand  controller  circuits  highlighted.  Figure  11-42 
illustrates  the  values  of  the  hand  controller  switch  inputs  when  the 
switch  is  open  or  closed. 

Table  11-22 

Hand  controller  connector  signals 


Pin 

Signal 

Description 

1 

GAMESWl 

Switch  input  1  (sometimes  called 
paddle  button  T). 

2 

+5V 

+5V  power  supply,  total  current  drain 
from  this  pin  must  not  exceed  100  mA. 

3 

GND 

System  ground. 

4,9 

Not  used  for  hand  controllers. 

5,8 

PDLO  and  PDLl 

Hand  controller  inputs;  each  of  these 
must  be  connected  to  a  150-KQ 
variable  resistor  connected  to  +5V. 

6 

N.C. 

Not  connected. 

7 

GAMESWO 

Switch  input  0  (sometimes  called 

paddle  button  0). 
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How  to  connect  switch  inputs 
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Hand  controller  circuits 
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Input  Current  25 
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Figure  1 1  -42 

Hand  controller  signals 


Hand  controller  input 
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The  hand  controller  inputs  are  connected  to  the  timing  inputs  of  an 
NE556  dual  analog  timer.  Addressing  $C07X  sends  a  signal  from 
MMU  pin  22  that  resets  both  timers  and  causes  their  outputs  to  go 
to  1  (high).  A  variable  resistance  of  up  to  150  KQ  connected 
between  one  of  these  inputs  and  the  +5V  supply  controls  the 
charging  time  of  one  of  the  two  0.022  microfarad  capacitors. 

When  the  voltage  on  the  capacitor  passes  a  certain  threshold,  the 
output  of  the  NE556  changes  back  to  0  Oow).  Programs  can 
determine  the  setting  of  a  variable  resistor  by  resetting  the  timers 
and  then  counting  time  until  the  selected  timer  input  changes  from 
high  to  low.  The  resulting  count  is  proportional  to  the  resistance. 


Warning      The  only  way  to  ensure  correct  paddle  values  is  to  make  sure 
the  output  of  the  paddle  you  Intend  to  read  Is  lov^^  before  you 
trigger  the  tinner,  Triggering  ttie  timer  starts  the  charging  cycle 
for  the  capacitor  in  each  paddle  circuit;  thte  cycle  for  one  may 
not  be  completed  by  the  time  you  have  read  the  other.  If  you 
retrigger  or  read  the  other  paddle  too  soon  (that  is,  in  less  than 
3  ms),  you  will  get  a  false  value  for  it. 
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Memory  expansion  card 


Memory  expansion  card  I/O  is  supported  by  an  internal  connector 
mounted  on  the  main  logic  board.  Figure  11-43  is  a  pinout  diagram 
for  this  connector. 

For  information  on  the  Apple  lie  Memory  Expansion  Card,  refer  to 
the  Apple  lie  Memory  Expansion  Card  Reference. 
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A4 
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14 

A5 
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15 

A6 

32 
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16 
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33 

Q3 

17 

A8 
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Figure  11-43 

Memory  expansion  card  connector  pinout  diagram 


Schematic  diagrams 

Figure  11-44,  on  the  following  pages,  is  a  set  of  schematic  diagrams 
for  the  Apple  lie. 


Schematic  diagrams 
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Appendix  A 


The  65C02    Microprocessor 


This  appendix  describes  the  differences  between  the  6502  and  the 
65C02  microprocessors.  It  also  contains  the  data  sheet  for  the  NCR 
65C02  microprocessor. 

In  the  data  sheet  tables,  execution  times  are  specified  in  numbers  of 
cycles.  One  cycle  for  the  Apple  lie  equals  0.978  microseconds. 

If  you  want  to  write  programs  that  execute  on  all  computers  in  the 
Apple  II  series,  make  sure  your  code  uses  only  the  subset  of  65C02 
instructions  present  on  the  6502. 


Differences  between  6502  and  65C02 

The  data  sheet  in  this  chapter  lists  the  new  65C02  instructions  and 
addressing  modes.  This  section  supplements  that  information  by 
listing  the  instructions  whose  execution  times  or  results  have 
changed  from  their  6502  counterparts. 


Differing  cycle  times 

In  general,  differences  in  execution  times  are  significant  only  in 
time-dependent  code,  such  as  precise  wait  loops.  Fortunately, 
instructions  with  changed  execution  times  are  few. 

Table  A-1  lists  the  65C02  instructions  whose  number  of  instruction 
execution  cycles  is  different  from  their  number  on  the  6502. 
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Table  A- 1 

Cycle  time  differences 


Instruction/mode 

Opcode 

6502 

65C02 

cycles 

cycles 

ASL  Absolute,  X 

IE 

7 

6 

DEC  Absolute,  X 

DE 

7 

6 

INC  Absolute,  X 

FE 

7 

6 

JMP  (Absolute) 

6C 

5 

6 

LSR  Absolute,  X 

5E 

7 

6 

ROL  Absolute,  X 

3E 

7 

6 

ROR  Absolute,  X 

7E 

7 

6 

Differing  instruction  results 

The  instructions  that  have  different  results  from  their  6502 
equivalents  are 

D  BIT  (in  immediate  mode) 

D  JMP  (indirect,  when  crossing  a  page  boundary). 

The  BIT  instruction  when  used  in  immediate  mode  (code  $89) 
leaves  processor  status  register  bits  7  (N)  and  6  (V)  unchanged  on 
the  65C02.  On  the  6502,  all  modes  of  the  BIT  instruction  have  the 
same  effect  on  the  status  register;  the  value  of  memory  bit  7  is 
placed  in  status  bit  7,  and  memory  bit  6  is  placed  in  status  bit  6. 
However,  all  BIT  instructions  on  both  versions  of  the  processor  set 
status  bit  1  (Z)  if  the  memory  location  being  tested  contains  a  0. 

If  the  JMP  indirect  instruction  (code  $6C)  references  an  indirect 
address  location  that  spans  a  page  boundary,  the  65C02  fetches  the 
high-order  byte  of  the  effective  address  from  the  first  byte  of  the 
next  page,  while  the  6502  fetches  it  from  the  first  byte  of  the  current 
page.  For  example,  JMP  ($02FF)  gets  ADL  from  location  $02FF  on 
both  processors.  On  the  65C02,  ADH  comes  from  $0300  while  on 
the  6502,  ADH  comes  from  $0200. 


Data  sheet 

The  rest  of  this  appendix  is  copyright  1982,  NCR  Corporation, 
Dayton,  Ohio,  and  is  reprinted  with  their  permission. 
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NCR 


NCR65C02 


-   GENERAL  DESCRIPTION 


>   PIN  CONFIGURATION 


The  NCR  CMOS  6502  is  an  8-bit  microprocessor  which  is  soft- 
ware compatible  with  the  NIVIOS  6502.  The  NCR65C02  hardware 
interfaces  with  all  6500  peripherals.  The  enhancements  include 
ten  additional  instructions,  expanded  operational  codes  and 
two  new  addressing  modes.  This  microprocessor  has  all  of  the  ad- 
vantages of  CMOS  technology:  low  power  consumption,  increased 
noise  immunity  and  higher  reliability.  The  CMOS  6502  is  a  low 
power  high  performance  microprocessor  with  applications  in  the 
consumer,  business,  automotive  and  communications  market. 


FEATURES 

Enhanced  software  performance  including  27  additional  OP  codes 
encompassing  ten  new  instructions  and  two  additional 
addressing  modes. 

66  microprocessor  instructions. 

15  addressing  modes. 

178  operational  codes. 

1MHz,  2MHz  operation. 

Operates  at  frequencies  as  low 

as  200  Hz  for  even  lower  power 

consumption  (pseudo-static:  stop  during  02  high) 

Compatible  with  NMOS  6500  series 
microprocessors. 
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■   NCR65C02  BLOCK  DIAGRAM 


64  K-byte  addressable  memory. 

Interrupt  capability. 

Lower  power  consumption. 
4mA  @  1MHz. 

-1-5  volt  power  supply. 

8-bit  bidirectional  data  bus. 

Bus  Compatible  with  M6800. 

Non-maskable  interrupt. 

40  pin  dual-in-line  packaging. 

8-bit  parallel  processing 

Decimal  and  binary  arithmetic. 

Pipeline  architecture. 

Programmable  stack  pointer. 

Variable  length  stack. 

Optional  internal  pullups  for 

(RDY,  IRQ,  SD,  NMIand  RES) 


Specifications  are  subject  to 
change  without  notice. 


Copyright  ©1982  by  NCR  Corporation,  Dayton,  Ohio,  USA 
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NCR65C02 

■  ABSOLUTE  MAXIMUM  RATINGS: 


(  Vdd  =  5.0  V  +  5%,  Vss  =  0  V,  Ta  =  ff"  to  +  70°C| 


RATING 

SYMBOL 

VALUE 

UNIT 

SUPPLY  VOLTAGE 

Vdd 

-0.3  to +7.0 

V 

INPUT  VOLTAGE 

V|N 

-0.3  to  +7.0 

v 

OPERATING  TEMP. 

Ta 

0  to  +  70 

°c 

STORAGE  TEMP. 

TsTG 

-55to+  150 

°c 

■   PIN  FUNCTION 


PIN 

FUNCTION 

AO- A15 

Address  Bus 

D0-D7 

Data  Bus 

IRQ* 

Interrupt  Request 

RDY" 

Ready 

ML 

Memory  Lock 

NMT 

Non-Maskable  Interrupt 

SYNC 

Synchronize 

RI5- 

Reset 

SO- 

Set Overflow 

NG 

No  Connection 

R/W 

Read/Write 

VDD 

Power  Supply  (+5V) 

VSS 

Internal  Logic  Ground 

00 

Clock  Input 

01,02 

Clock  Output 

*This  pin  has  an  optional  internal  pullup  for  a  No  Connect  condition. 

■   DC  CHARACTERISTICS 


SYMBOL 

MIN. 

TYP. 

MAX 

UNIT 

Input  High  Voltage 

00  (IN) 
Input  High  Voltage 

RES,  NMI,  RDY,  IRQ,  Data,  S.O. 

V|H 

Vss  +  2.4 
Vss  +  2.0 

- 

Vdd 

V 
V 

Input  Low  Voltage 
00  (IN) 
RES,  NMI,  RDY,  IRQ,  Data,  S.O. 

V|L 

Vss  -0.3 

- 

Vss+0.4 
Vss  +  0.8 

V 
V 

Input  Leakage  Current 

(V|N  =0  to  5.25V,  Vdd  =  5.25V) 
With  pullups 
Without  pullups 

l|N 

-30 

- 

+30 
+  1.0 

^A 
fiA 

Three  State  (Off  State)  Input  Current 
(V|N  =  0.4  to  2.4V,  Vcc  =  5.25V) 
Data  Lines 

Itsi 

10 

MA 

Output  High  Voltage 

doH  =-100  AAdc,    Vdd=4.75V 
SYNC,  Data,  A0-A15,  R/W) 

VOH 

Vss  +  2.4 

V 

Out  Low  Voltage 

(l0L  =  l.emAdc,   Vdd  =  4.75V 
SYNC,  Data,  A0-A15,  R/W) 

Vol 

Vss  +  0-4 

V 

Supply  Current  f  =  1MHz 
Supply  Current  f  =  2MHz 

Idd 

Idd 

- 

— 

4 
8 

mA 
mA 

Capacitance 

{V|N  =0,  Ta  =25''C,  f  =  1MHz) 
Logic 
Data 

A0-A15,  R/W,  SYNC 
00  (IN) 

C 

Qn 

Cout 
C0o(IN) 

- 

- 

5 
10 
10 
10 

pF 
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NCR65C02 

■     AC  CHARACTERISTICS     Vqd  =  S.OV  t  5%,  Ta  =  0°C  to  70°C,  Load  =  1  TTL  +  130  pF 

IMHZ 

2MHZ 

3MHZ 

Parameter 

Symbol 

Min 

Max 

Min 

Max 

Min 

Max 

Unit 

Delay  Time,  0o  (IN)  to  02  (OUT) 

toLY 

- 

60 

- 

60 

20 

60 

nS 

Delay  Time,  0i  (OUT)  to  02  (OUT) 

toLYl 

-20 

20 

-20 

20 

-20 

20 

nS 

Cycle  Time 

tcYC 

1.0 

5000* 

0.50 

5000* 

0.33 

5000* 

/IS 

Clock  Pulse  Width  Low 

tpL 

460 

- 

220 

- 

160 

- 

nS 

Clock  Pulse  Width  High 

tpH 

460 

- 

220 

- 

160 

- 

nS 

Fall  Time,  Rise  Time 

tp.tR 

- 

25 

- 

25 

- 

25 

nS 

Address  Hold  Time 

tAH 

20 

- 

20 

- 

0 

- 

nS 

Address  Setup  Time 

■tADS 

- 

225 

- 

140 

- 

110 

nS 

Access  Time 

tACC 

650 

- 

310 

- 

170 

- 

nS 

Read  Data  Hold  Time 

toHR 

10 

- 

10 

- 

10 

- 

nS 

Read  Data  Setup  Time 

tosu 

100 

- 

60 

- 

60 

- 

nS 

Write  Data  Delay  Time 

tMDS 

- 

30 

- 

30 

- 

30 

nS 

Write  Data  Hold  Time 

toHW 

20 

- 

20 

- 

15 

- 

nS 

SO  Setup  Time 

tso 

100 

- 

100 

- 

100 

- 

nS 

Processor  Control  Setup  Time** 

tpcs 

200 

- 

150 

- 

150 

- 

nS 

SYNC  Setup  Time 

tsYNC 

- 

225 

- 

140 

- 

100 

nS 

ML  Setup  Time 

twL 

- 

225 

- 

140 

- 

100 

nS 

Input  Clock  Rise/Fall  Time 

tF8o.tR9o 

- 

25 

- 

25 

- 

25 

nS 

*NCR65C02  can  be  held  static  with 
**This  parameter  must  only  be  met 


02  high. 

to  guarantee  that  the  signal  will  be  recognized  at  the  current  clock  cycle. 


-   MICROPROCESSOR  OPERATIONAL  ENHANCEMENTS 


Function 

NMOS  6502   Microprocessor 

NCR65C02  Microprocessor 

Indexed  addressing  across  page  boundary 

Extra  read  of  invalid  address. 

Extra  read  of  last  instruction  byte. 

Execution  of  invalid  op  codes. 

Some  terminate  only  by  reset.  Results 
are  undefined. 

AM  are'  NOPs  (reserved  for  future  use). 
Op  Code                   Bytes           Cycles 
X2                                 2                    2 
X3,  X7,  XB,  XF           1                    1 
44                                  2                    3 
54,  D4,  F4                    2                   4 
5C                                  3                   8 
DC,  FC                         3                   4 

Jump  indirect,  operand  =  XXFF. 

Page  address  does  not  increment. 

Page  address  increments  and  adds  one 
additional  cycle. 

Read/modify/write  instructions  at 
effective  address. 

One  read  and  two  write  cycles. 

Two  read  and  one  write  cycle. 

Decimal  flag. 

Indeterminate  after  reset. 

Initialized  to  binary  mode  (D=0)  after 
reset  and  interrupts. 

Flags  after  decimal  operation. 

Invalid  N,  V  and  2  flags. 

Valid  flag  adds  one  additional  cycle. 

Interrupt  after  fetch  of  BRK  instruc- 
tion, 

Interrupt  vector  is  loaded,  BRK  vector 
is  ignored. 

BRK  is  executed,  then  interrupt  is 
executed. 

■   MICROPROCESSOR  HARDWARE  ENHANCEMENTS 


Function 

NMOS  6502 

NCR65C02 

Assertion  of  Ready  RDY  during 
write  operations. 

Ignored. 

Stops  processor  during  02- 

Unused  input-only  pins  (IRQ,  NMI, 
RDY,  HbS,  SO). 

Must  be  connected  to  low  impedance 
signal  to  avoid  noise  problems. 

Connected  internally  by  a  high- 
resistance  to  Vdd  (approximately  250 
Kohm.) 
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■   TIMING  DIAGRAM 


00 

01 

82 

ADDR,  R/W 
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WRITE  DATA 
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ML 
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Note:  All  timing  is  referenced  fronn  a  high  voltage  of  2.0  volts  and  a  low  voltage  of  0.8  volts. 


■   NEW  INSTRUCTION  MNEMONICS 


HEX 

MNEMONIC 

80 

BRA 

3A 

DBA 

1A 

INA 

DA 

PHX 

5A 

PHY 

FA 

PLX 

7A 

PLY 

9C 

STZ 

9E 

STZ 

64 

STZ 

74 

STZ 

1C 

TRB 

14 

TRB 

OC 

TSB 

04 

TSB 

ITIONAL 

HEX 

INSTRUCTIO 

MNEMONIC 

72 

ADC 

32 

AND 

3C 

BIT 

34 

BIT 

D2 

CMP 

52 

EGR 

7C 

JMP 

B2 

LDA 

12 

ORA 

F2 

SBC 

92 

STA 

DESCRIPTION 

Branch  relative  always  [Relative] 

Decrennent  accumulator  [Accuml 

Increment  accumulator  [Accum] 

Push  X  on  stack  llmpliedl 

Push  Y  on  stack  [Implied] 

Pull  X  from  stack  [Implied] 

Pull  Y  from  stack  [Implied) 

Store  zero  (Absolute] 

Store  zero  [ABS,  Xl 

Store  zero  [Zero  page] 

Store  zero  [ZPG.X] 

Test  and  reset  memory  bits  with  accumulator  [Absolute] 

Test  and  reset  memory  bits  with  accumulator  [Zero  page] 

Test  and  set  memory  bits  with  accumulator  [Absolute] 

Test  and  set  memory  bits  with  accumulator  [Zero  page] 


DESCRIPTION 

Add  memory  to  accumulator  with  carry  [(ZPG)] 

"AND"  memory  with  accumulator  [(ZPGI] 

Test  memory  bits  with  accumulator  [ABS,  X] 

Test  memory  bits  with  accumulator  [ZPG,  X) 

Compare  memory  and  accumulator  [(ZPG)  J 

"Exclusive  Or"  memory  with  accumulator  [(ZPGH 

Jump  (New  addressing  mode)  [ABS(iND,XI] 

Load  accumulator  with  memory  [(ZPG)] 

"OR"  memory  with  accumulator  [(ZPG)l 

Subtract  memory  from  accumulator  with  borrow  [(ZPG) 

Store  accumulator  in  memory  [(ZPG)] 
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-   MICROPROCESSOR  PROGRAMMING  MODEL 


15 


QE 


ACCUMULATOR  A 


INDEX  REGISTER  Y 


N  lyM   |B|  pi  I  I  Z|C 


^  INDEX  REGISTER  X 

"J  PROGRAM  COUNTER  PC 


STACK  POINTER  S 


PROCESSOR  STATUS 
REG  ■■?■■ 


-CARRY  1  .  TRUE 
-ZERO  1  .RESULT  ZERO 
-  IRQ  DISABLE  1  =  DISABLE 
-DECIMAL  MODE  1  =  TRUE 
-BRK  COMMAND  1  =  BRK 
-OVERFLOW  1  . TRUE 
-NEGATIVE  1  -  NEG. 


■   FUNCTIONAL  DESCRIPTION 


Timing  Control 

The  timing  control  unit  keeps  track  of  the  instruction 
cycle  being  monitored.  The  unit  is  set  to  zero  each  time 
an  instruction  fetch  is  executed  and  is  advanced  at  the 
beginning  of  each  phase  one  clock  pulse  for  as  many 
cycles  as  is  required  to  complete  the  instruction.  Each 
data  transfer  which  takes  place  between  the  registers  de- 
pends upon  decoding  the  contents  of  both  the  instruc- 
tion register  and  the  timing  control  unit. 

Program  Counter 

The  16-bit  program  counter  provides  the  addresses  which 
step  the  microprocessor  through  sequential  instructions 
in  a  program. 

Each  time  the  microprocessor  fetches  an  instruction 
from  program  memory,  the  lower  byte  of  the  program 
counter  {PCL)  is  placed  on  the  low-order  bits  of  the 
address  bus  and  the  higher  byte  of  the  program  counter 
(PCH)  is  placed  on  the  high-order  8  bits.  The  counter  is 
incremented  each  time  an  instruction  or  data  is  fetched 
from  program  memory. 

Instruction  Register  and  Decode 

Instructions  fetched  from  memory  are  gated  onto  the 
internal  data  bus.  These  instructions  are  latched  into  the 
instruction  register,  then  decoded,  along  with  timing  and 
interrupt  signals,  to  generate  control  signals  for  the  var- 
ious registers. 

Arithmetic  and  Logic  Unit  (ALU) 

All  arithmetic  and  logic  operations  take  place  in  the 
ALU  including  incrementing  and  decrementing  internal 
registers  (except  the  program  counter).  The  ALU  has  no 
internal  memory  and  is  used  only  to  perform  logical  and 
transient  numerical  operations. 


Accumulator 

The  accumulator  is  a  general  purpose  8-bit  register  that 
stores  the  results  of  most  arithmetic  and  logic  operations, 
and  in  addition,  the  accumulator  usually  contains  one  of 
the  two  data  words  used  in  these  operations. 

Index  Registers 

There  are  two  8bit  index  registers  (X  and  Y),  which 
may  be  used  to  count  program  steps  or  to  provide  an 
index  value  to  be  used  in  generating  an  effective  address. 
When  executing  an  instruction  which  specifies  indexed 
addressing,  the  CPU  fetches  the  op  code  and  the  base 
address,  and  modifies  the  address  by  adding  the  index 
register  to  it  prior  to  performing  the  desired  operation. 
Pre-  or  post-indexing  of  indirect  addresses  is  possible  (see 
addressing  modes). 

Stack  Pointer 

The  stack  pointer  is  an  8-bit  register  used  to  control  the 
addressing  of  the  variable-length  stack  on  page  one.  The 
stack  pointer  is  automatically  incremented  and  decre- 
mented under  control  of  the  microprocessor  to  perform 
stack  manipulations  under  direction  of  either  the  program 
or  interrupts  (NMI  and  IRQ).  The  stack  allows  simple 
implementation  of  nested  subroutines  and  multiple  level 
interrupts.  The  stack  pointer  should  be  initialized  before 
any  interrupts  or  stack  operations  occur. 

Processor  Status  Register 

The  8-bit  processor  status  register  contains  seven  status 
flags.  Some  of  the  flags  are  controlled  by  the  program, 
others  may  be  controlled  both  by  the  program  and  the 
CPU.  The  6500  instruction  set  contains  a  number  of 
conditional  branch  instructions  which  are  designed  to 
allow  testing  of  these  flags  (see  microprocessor  program- 
ming model). 
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■   ADDRESSING  MODES 

Fifteen  addressing  modes  are  available  to  the  user  of  the 
NCR65C02  microprocessor.  The  addressing  modes  are 
described  in  the  following  paragraphs: 

Implied  Addressing  [Implied] 

In  the  implied  addressing  mode,  the  address  containing 
the  operand  is  implicitly  stated  in  the  operation  code  of 
the  instruction. 

Accumulator  Addressing  [Accum] 

This  form  of  addressing  is  represented  with  a  one  byte 
instruction  and  implies  an  operation  on  the  accumu- 
lator. 

Immediate  Addressing  [Immediate] 

With  immediate  addressing,  the  operand  is  contained  in 
the  second  byte  of  the  instruction;  no  further  memory 
addressing  is  required. 

Absolute  Addressing  [Absolute] 

For  absolute  addressing,  the  second  byte  of  the  instruc- 
tion specifies  the  eight  low-order  bits  of  the  effective 
address,  whilethe third  byte  specifies  the  eight  high-order 
bits.  Therefore,  this  addressing  mode  allows  access  to  the 
total  64K  bytes  of  addressable  memory. 

Zero  Page  Addressing  [Zero  Page] 

Zero  page  addressing  allows  shorter  code  and  execution 
times  by  only  fetching  the  second  byte  of  the  instruction 
and  assuming  a  zero  high  address  byte.  The  careful  use 
of  zero  page  addressing  can  result  in  significant  increase 
in  code  efficiency. 

Absolute  Indexed  Addressing  [ABS,  X  or  ABS,  Y] 

Absolute  indexed  addressing  is  used  in  conjunction  with 
X  or  Y  index  register  and  is  referred  to  as  "Absolute,  X," 
and  "Absolute,  Y."  The  effective  address  is  formed  by 
adding  the  contents  of  X  or  Y  to  the  address  contained 
in  the  second  and  third  bytes  of  the  instruction.  This 
mode  allows  the  index  register  to  contain  the  index  or 
count  value  and  the  instruction  to  contain  the  base 
address.  This  type  of  indexing  allows  any  location  refer- 
encing and  the  index  to  modify  multiple  fields,  resulting 
in  reduced  coding  and  execution  time. 

Zero  Page  Indexed  Addressing  [ZPG,  X  or  ZPG,  Y] 
Zero  page  absolute  addressing  is  used  in  conjunction 
with  the  index  register  and  is  referred  to  as  "Zero  Page, 
X"  or  "Zero  Page,  Y."  The  effective  address  is  calculated 
by  adding  the  second  byte  to  the  contents  of  the  index 
register.  Since  this  is  a  form  of  "Zero  Page"  addressing, 
the  content  of  the  second  byte  references  a  location  in 
page  zero.  Additionally,  due  to  the  "Zero  Page"  address- 
ing nature  of  this  mode,  no  carry  is  added  to  the  high- 
order  eight  bits  of  memory,  and  crossing  of  page  boun- 
daries does  not  occur. 

Relative  Addressing  [Relative] 

Relative  addressing  is  used  only  with  branch  instructions; 


it  establishes  a  destination  for  the  conditional  branch. 
The  second  byte  of  the  instruction  becomes  the  operand 
which  is  an  "Offset"  added  to  the  contents  of  the  pro- 
gram counter  when  the  counter  is  set  at  the  next  In- 
struction. The  range  of  the  offset  is  -128  to  +127 
bytes  from  the  next  instruction. 
Zero  Page  Indexed  Indirect  Addressing  [(IND,  X)] 
With  zero  page  indexed  indirect  addressing  (usually  re- 
ferred to  as  Indirect  X)  the  second  byte  of  the  instruction 
Is  added  to  the  contents  of  the  X  index  register;  the 
carry  is  discarded.  The  result  of  this  addition  points  to  a 
memory  location  on  page  zero  whose  contents  is  the  low- 
order  eight  bits  of  the  effective  address.  The  next  mem- 
ory location  in  page  zero  contains  the  high-order  eight 
bits  of  the  effective  address.  Both  memory  locations 
specifying  the  high-  and  low-order  bytes  of  the  effective 
address  must  be  in  page  zero. 

"Absolute  Indexed  Indirect  Addressing  [ABSlIND,  X)] 
(Jump  Instruction  Only] 

With  absolute  indexed  indirect  addressing  the  contents  of 
the  second  and  third  instruction  bytes  are  added  to  the 
X  register.  The  result  of  this  addition,  points  to  a  memory 
location  containing  the  lower-order  eight  bits  of  the 
effective  address.  The  next  memory  location  contains 
the  higher-order  eight  bits  of  the  effective  address. 

Indirect  Indexed  Addressing   [(IND),  Y] 

This  form  of  addressing  Is  usually  referred  to  as  Indirect, 
Y.  The  second  byte  of  the  instruction  points  to  a  mem- 
ory location  In  page  zero.  The  contents  of  this  memory 
location  are  added  to  the  contents  of  the  Y  index  regis- 
ter, the  result  being  the  low-order  eight  bits  of  the  effec- 
tive address.  The  carry  from  this  addition  is  added  to  the 
contents  of  the  next  page  zero  memory  location,  the 
result  being  the  high-order  eight  bits  of  the  effective 
address. 

"Zero  Page  Indirect  Addressing  [(ZPG)] 
In  the  zero  page  indirect  addressing  mode,  the  second 
byte  of  the  instruction  points  to  a  memory  location  on 
page  zero  containing  the  low-order  byte  of  the  effective 
address.  The  next  location  on  page  zero  contains  the 
high -order  byte  of  the  effective  address. 

Absolute  Indirect  Addressing  [(ABS)] 
(Jump  Instruction  Only) 

The  second  byte  of  the  Instruction  contains  the  low-order 
eight  bits  of  a  memory  location.  The  high-order  eight 
bits  of  that  memory  location  is  contained  in  the  third 
byte  of  the  instruction.  The  contents  of  the  fully  speci- 
fied memory  location  is  the  low-order  byte  of  the  effec- 
tive address.  The  next  memory  location  contains  the 
high-order  byte  of  the  effective  address  which  is  loaded 
into  the  16  bit  program  counter. 


NOTE: 


■■  New  Address  Modes 
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■   SIGNAL  DESCRIPTION 

Address  Bus  (A0-A15I 

A0-A15  forms  a  16-bit  address  bus  for  memory  and  I/O 
exchanges  on  the  data  bus.  The  output  of  each  address 
line  is  TTL  compatible,  capable  of  driving  one  standard 
TTL  load  and  130pF. 

Clocks  (Oq,  01,  and  92) 

00  is  a  TTL  level  input  that  is  used  to  generate  the  inter- 
nal clocks  in  the  6502.  Two  full  level  output  clocks  are 
generated  by  the  6502,  The  02  clock  output  is  in  phase 
with  00.  The  0i  output  pin  is  180°  out  of  phase  with  Oq. 
(See  timing  diagram.) 

Data  Bus  (D0-D7) 

The  data  lines  {D0-D7)  constitute  an  8-bit  bidirectional 
data  bus  used  for  data  exchanges  to  and  from  the  device 
and  peripherals.  The  outputs  are  three-state  buffers 
capable  of  driving  one  TTL  load  and  130  pF. 

Interrupt  Request  (IRQ) 

This  TTL  compatible  input  requests  that  an  interrupt 
sequence  begin  within  the  microprocessor.  The  IRQ  is 
sampled  during  02  operation;  if  the  interrupt  flag  in  the 
processor  status  register  is  zero,  the  current  instruction 
is  completed  and  the  interrupt  sequence  begins  during 
01.  The  program  counter  and  processor  status  register 
are  stored  in  the  stack.  The  microprocessor  will  then  set 
the  interrupt  mask  flag  high  so  that  no  further  IRQs 
may  occur.  At  the  end  of  this  cycle,  the  program  counter 
low  will  be  loaded  from  address  FFFE,  and  program 
counter  high  from  location  FFFF,  transferring  program 
control  to  the  memory  vector  located  at  these  addresses. 
The  RDY  signal  must  be  in  the  high  state  for  any  inter- 
rupt to  be  lecognized.  A  3K  ohm  external  resistor  should 
be  used  for  proper  wire  OR  operation. 

Memory  Lock  (ML)  

In  a  multiprocessor  system,  the  ML  output  indicates  the 
need  to  defer  the  rearbitration  of  the  next  bus  cycle  to 
ensure  the  integrity  of  read-modify-write  instructions. 
ML  goes  low  during  ASL,  DEC,  INC,  LSR,  ROL,  ROR, 
TRB,  TSB  memory  referencing  instructions.  This  signal 
is  low  for  the  modify  and  write  cycles. 

Non-Maskable  interrupt  (NMl) 

A  negative-going  edge  on  this  input  requests  that  a  non- 
maskable interrupt  sequence  be  generated  within  the 
microprocessor.  The  NMl  is  sampled  during  02,  the  cur- 
rent instruction  is  completed  and  the  interrupt  sequence 
begins  during  01.  The  program  counter  is  loaded  with 
the  interrupt  vector  from  locations  FFFA  (low  byte) 
and  FFFB  (high  byte),  thereby  transferring  program  con- 
trol to  the  non-maskable  interrupt  routine. 


NCR65C02 


Ready  (RDY) 

This  input  allows  the  user  to  single-cycle  the  micropro- 
cessor on  all  cycles  including  write  cycles.  A  negative 
transition  to  the  low  state,  during  or  coincident  with 
phase  one  (0i),  will  halt  the  microprocessor  with  the  out- 
put address  lines  reflecting  the  current  address  being 
fetched.  This  condition  will  remain  through  asubsequent 
phase  two  (02)  in  which  the  ready  signal  is  low.  This  fea- 
ture allows  microprocessor  interfacing  with  low-speed 
memory  as  well  as  direct  memory  access  (DMA), 

Reset  (RES) 

This  input  is  used  to  reset  the  microprocessor.  Reset 
must  be  held  low  for  at  least  two  clock  cycles  after 
Vdd  reaches  operating  voltage  from  a  power  down,  A 
positive  transistion  on  this  pin  will  then  cause  an  initiali- 
zation sequence  to  begin.  Likewise,  after  the  system  has 
been  operating,  a  low  on  this  line  of  at  least  two  cycles 
will  cease  microprocessing  activity,  followed  by  initial- 
ization after  the  positive  edge  on  RES, 

When  a  positive  edge  is  detected,  there  is  an  initialization 
sequence  lasting  six  clock  cycles.  Then  the  interrupt 
mask  flag  is  set,  the  decimal  mode  is  cleared,  and  the  pro- 
gram counter  is  loaded  with  the  restart  vector  from  loca- 
tions FFFC  (low  byte)  and  FFFD  (high  byte).  This  is 
the  start  location  for  program  control.  This  input  should 
be  high  in  normal  operation. 

Read/Write  (R/W) 

This  signal  is  normally  in  the  high  state  indicating  that 
the  microprocessor  is  reading  data  from  memory  or  I/O 
bus.  In  the  low  state  the  data  bus  has  valid  data  from  the 
microprocessor  to  be  stored  at  the  addressed  memory 
location. 

Set  Overflow  (SO) 

A  negative  transition  on  this  line  sets  the  overflow  bit  in 
the  status  code  register.  The  signal  is  sampled  on  the  trail- 
ing edge  of  0j. 

Synchronize  (SYNC) 

This  output  line  is  provided  to  identify  those  cycles  dur- 
ing which  the  microprocessor  is  doing  an  OP  CODE 
fetch.  The  SYNC  line  goes  high  during  df  of  anOP  CODE 
fetch  and  stays  high  for  the  remainder  of  that  cycle.  If 
the  RDY  line  is  pulled  low  during  the  01  clock  pulse  in 
which  SYNC  went  high,  the  processor  will  stop  in  its 
current  state  and  will  remain  in  the  state  until  the  RDY 
line  goes  high.  In  this  manner,  the  SYNC  signal  can  be 
used  to  control  RDY  to  cause  single  instruction  execu- 
tion. 


Note;  Since  this  interrupt  is  non-maskable,  another  NMl 
can  occur  before  the  first  is  finished.  Care  should  be  taken 
when  using  NMl  to  avoid  this. 
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NCR65C02 

-   INSTRUCTION  SET  -  ALPHABETICAL  SEQUENCE 


ADC  Add  Memory  to  Accumulator  with  Carry 

AND  "AND"  Memory  with  Accumulator 

ASL  Shift  One  Bit  Left 

BCC  Branch  on  Carry  Clear 

BCS  Branch  on  Carry  Set 

BEQ  Branch  on  Result  Zero 

BIT  Test  Memory  Bits  with  Accumulator 

BMI  Branch  on  Result  Minus 

BNE  Branch  on  Result  not  Zero 

BPL  Branch  on  Result  Plus 

"BRA  Branch  Always 

BRK  Force  Break 

BVC  Branch  on  Overflow  Clear 

BVS  Branch  on  Overflow  Set 

CLC  Clear  Carry  Flag 

CLD  Clear  Decimal  Mode 

CLI  Clear  Interrupt  Disable  Bit 

CLV  Clear  Overflow  Flag 

CMP  Compare  Memory  and  Accumulator 

CPX  Compare  Memory  and  Index  X 

CPY  Compare  Memory  and  Index  Y 

•  DEA  Decrement  Accumulator 
DEC  Decrement  by  One 

DEX  Decrement  Index  X  by  One 

DEY  Decrement  Index  Y  by  One 

EOR  "Exclusive-or"  Memory  with  Accumulator 

*  INA  Increment  Accumulator 
INC  Increment  by  One 

INX  Increment  Index  X  by  One 

INY  Increment  Index  Y  by  One 

JMP  Jump  to  New  Location 

JSR  Jump  to  New  Location  Saving  Return  Address 

LDA  Load  Accumulator  with  Memory 

Note:  *  =  New  Instruction 

■   MICROPROCESSOR  OP  CODE  TABLE 


LDX  Load  Index  X  with  Memory 

LDY  Load  Index  Y  with  Memory 

LSR  Shift  One  Bit  Right 

NOP  No  Operation 

ORA  "OR"  Memory  with  Accumulator 

PHA  Push  Accumulator  on  Stack 

PHP  Push  Processor  Status  on  Stack 

•  PHX  Push  Index  X  on  Stack 

•  PHY  Push  Index  Y  on  Stack 

PLA  Pull  Accumulator  from  Stack 

PLP  Pull  Processor  Status  from  Stack 

•  PLX  Pull  Index  X  from  Stack 

•  PLY  Pull  Index  Y  from  Stack 
ROL  Rotate  One  Bit  Left 
ROR  Rotate  One  Bit  Right 
RTI  Return  from  Interrupt 
RTS  Return  from  Subroutine 

SBC  Subtract  Memory  from  Accumulator  with  Borrow 

SEC  Set  Carry  Flag 

SEP  Set  Decimal  Mode 

3EI  Set  Interrupt  Disable  Bit 

STA  Store  Accumulator  in  Memory 

STX  Store  Index  X  in  Memory 

STY  Store  Index  Y  in  Memory 

■  STZ  Store  Zero  in  Memory 

TAX  Transfer  Accumulator  to  Index  X 

TAY  Transfer  Accumulator  to  Index  Y 

■  TRB  Test  and  Reset  Memory  Bits  with  Accumulator 
"  TSB  Test  and  Set  Memory  Bits  with  Accumulator 

TSX  Transfer  Stack  Pointer  to  Index  X 

TXA  Transfer  Index  X  to  Accumulator 

TXS  Transfer  Index  X  to  Stack  Pointer 

TYA  Transfer  Index  Y  to  Accumulator 


s 

D 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

0 

BRK 

ORA 

ind,  X 

TSB- 
zpg 

ORA 
zpg 

ASL 
zpg 

PHP 

ORA 

ASL 
A 

TSB- 
abs 

ORA 
abs 

ASL 
abs 

0 

1 

BPL 

ORA 

Ind,  Y 

ORA-t 

(zpg) 

TRB- 

.pg 

ORA 
zpg,  X 

ASL 

zpg,  X 

CLC 

ORA 
abs,  Y 

INA- 
A 

TRB- 
abs 

ORA 
abs,  X 

ASL 

abs,  X 

1 

2 

JSR 
3bs 

AND 
ind,  X 

BIT 

!pg 

AND 
zpg 

ROL 
zpg 

PLP 

AND 

imm 

ROL 
A 

BIT 
abs 

AND 
abs 

ROL 
abs 

2 

3 

SMI 
rel 

AND 
ind,  Y 

AND-t 
Izpg) 

BIT- 

!pg,  X 

AND 

zpg,  X 

ROL 

zpg,  X 

SEC 

AND 
abs,  Y 

DEA- 
A 

BIT-t 
abs,X 

AND 
abs,  X 

ROL 
abs,  X 

3 

4 

RTI 

EOR 
ind,  X 

EOR 
zpg 

LSR 
zpg 

PHA 

EOR 

imm 

LSR 
A 

JMP 
abs 

EOR 

abs 

LSR 
abs 

4 

5 

BVC 

re! 

EOR 
ind,  Y 

EOR't 

(jpgl 

EOR 
zpg,  X 

LSR 
zpg,  X 

CLI 

EOR 
abs,  Y 

PHY- 

EOR 
abs,  X 

LSR 
abs,  X 

5 

6 

RTS 

ADC 
ind,  X 

STZ- 
ipg 

ADC 

zpg 

ROR 
zpg 

PLA 

ADC 

ROR 
A 

JMP 
(absl 

ADC 

abs 

ROR 

abs 

6 

7 

BVS 

rel 

ADC 

ind.  Y 

ADC-t 

(zpgl 

STZ- 

zpg,  X 

ADC 
zpg,  X 

ROR 
zpg,  X 

SEI 

ADC 
abs,  Y 

PLY- 

JMP't 
abs  find,  XI 

ADC 
abs,  X 

ROR 
abs,  X 

7 

8 

BRA' 

rel 

STA 

ind,  X 

STY 
!09 

STA 

zpg 

STX 
zpg 

DEY 

BIT- 

TXA 

STY 
abs 

STA 
abs 

STX 
abs 

8 

9 

BCC 

rel 

STA 
ind,  Y 

STA-t 

(2pgl 

STY 

zpg.  X 

STA 

zpg,  X 

STX 

zpg,  Y 

TYA 

STA 
abs,  Y 

TXS 

ST2- 
abs 

STA 

abs,  X 

STZ- 

abs,  X 

9 

A 

LDY 

LOA 

ind,  X 

LDX 

LDY 
zpg 

LDA 
zpg 

LDX 
zpg 

TAY 

LDA 

imm 

TAX 

LDY 
abs 

LDA 
abs 

LDX 
abs 

A 

B 

BCS 

rel 

LDA 
ind,  Y 

LDA-t 

(zpgl 

LDY 
zpg,  X 

LDA 

zpg,  X 

LDX 
zpg,  Y 

CLV 

LDA 
abs,  Y 

TSX 

LDY 
abs,  X 

LDA 
abs,  X 

LDX 
abs,  Y 

8 

C 

CPY 

imm 

CMP 
ind,  X 

CPY 
zpg 

CMP 

zpg 

DEC 

zpg 

INY 

CMP 

imm 

DEX 

CPY 
abs 

CMP 
abs 

DEC 
abs 

C 

D 

BNE 
rel 

CMP 
ind,  Y 

CMP-t 

Upgl 

CMP 

zpg,  X 

DEC 
zpg,  X 

CLD 

CMP 
abs,  Y 

PHX- 

CMP 
abs,  X 

DEC 
abs,  X 

D 

E 

CPX 

imm 

SBC 

ind,  X 

CPX 
zpg 

SBC 

zpg 

INC 

zpg 

INX 

SBC 

imm 

NOP 

CPX 
abs 

SBC 
abs 

INC 
abs 

E 

F 

BEQ 

rel 

SBC 

ind,  Y 

SBC-t 
(zpgl 

SBC 

zpg,  X 

INC 

zpg,  X 

SED 

SBC 

abs,  Y 

PLX- 

SBC 
abs,  X 

INC 
abs,  X 

F 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

Note:  *  =  New  OP  Codes 
Note:  t  =  New  Address  Modes 


306 


Appendix  A:  The  65C02  Microprocessor 


OPERATIONAL  CODES,  EXECUTION  TIME,  AND  MEMORY 
REQUIREMENTS 


NCR65C02 


IMME 
01  ATE 

ABSO- 
LUTE 

ZERO 
PAGE 

Accu^ 

IM- 
PLIED 

UND. 
X) 

(INDI 

Y 

ZPG.  X 

ZPG,  Y 

ABS,  X 

ABS.Y 

RELA 
T1VE 

(ABS) 

ABS 
IND.X 

(ZPG) 

PROCESSOR 
STATUS  CODES 

MNE 

OPERATION 

OP 

n 

OP 

n 

# 

OP 

n 

# 

OP 

„ 

# 

OP 

„ 

§ 

OP 

n 

# 

OP 

n   * 

OP 

^ 

it 

OP 

n   » 

OP 

„ 

§ 

OP 

n  » 

OP 

n  ll 

OP 

§ 

OP 

1  K 

OP 

n  « 

7  6  5  4   3  2    10 

IriNE 

N  V       B  0   1   Z  C 

ADC 
AND 
ASL 
BCC 
BCS 

A*M*C-A              (1,3) 
AAM-A                     (11 
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Branch  if  C=0               (21 
Branch  if  C=1                (21 

69 
29 
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60 
20 

OE 

4 
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6 

3 
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3 
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06 
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5 

2 
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2 
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2 
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21 

6 
6 

2 
2 
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6 
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2 
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6 
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3 
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89 

2 

2C 

4 

3 

24 

3 

2 

34 

4 

2 

3C 

4 

3 

FO 

30 
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10 
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BIT 
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BNE 
BPL 

BBA 
BRK 
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BVS 
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O'C 

00 
18 

7 
2 

1 

80 

50 

70 

2  2 

22 

2  2 

0 

0 
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BVC 
BVS 
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CLD 
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CLV 
CMP 
CPX 

0*D 
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0*V 
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X     M 
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EO 
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2 
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EC 
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4 
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3 

C5 
E4 
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3 
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2 

D8 
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6S 
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2 

2 

1 
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6 

2 

Dl 

5 

D5 

4 

2 

00 

3 

09 

4 

02 

53 
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0 

0 

N Z  C 
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CLD 
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DEY 
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5 
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LSR 
NOP 
ORA 
PHA 
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4A 

2 

EA 

48 

08 

2 

3 
3 

1 

1 
1 

01 

6 

2 

11 

5 

56 

2   15 

6 
4 

2 
2 

5E 
ID 

3 
3 

19 

4 

12 

5 

0    .         .             2  C 
N    .         .     .     .    Z    . 

LSR 
NOP 
ORA 
PHA 
PHP 

PC  t  1  *  PC 

AVM-A                     Ml 
A*M5    S     1  *S 
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04 

5 

5 

2 
2 

BA 
8A 
9A 

2 
2 
2 

1 

1 
1 

2 

Z   . 

N                 .         2   . 
N   .                       2  . 

TRB 

TSB 
TSX 
TXA 
TXS 

TYA 

Y  ♦A 

98 

2 
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N                     .     2  . 

TYA 

Notes: 

1 .  Add  1  to  "n"  if  page  boundary  is  crossed. 

2.  Add  1  to  "n"  if  branch  occurs  to  same  page. 
Add  2  to  "n"  if  branch  occurs  to  different  page. 

3.  Add  1  to  "n"  if  decimal  mode. 

4.  V  bit  equals  memory  bit  6  prior  to  execution. 
N  bit  equals  memory  bit  7  prior  to  execution. 

"5.    The  immediate  addressing  mode  of  the  BIT  instruction  leaves  bits  6  &  7 
(V  &  N)  in  the  Processor  Status  Code  Register  unchanged. 
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Memory  per  effective  address 
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Or 
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Memory  per  stack  pointer 
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n     No.  Cycles 
it    No.  Bytes 
Mg   Memory  bit  6 
M7    Memory  bit  7 
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Appendix  B 


Memory  Map 


This  appendix  lists  all  important  RAM  and  hardware  locations  in 
address  order  and  briefly  describes  them.  Appendix  C  contains  a 
similar  list  for  important  firmware  addresses. 

The  tables  in  this  appendix  list  addresses  in  either  two  or  three 
forms:  the  hexadecimal  form  (preceded  by  a  dollar  sign)  for  use  in 
assembly  language;  the  decimal  form  for  use  in  Applesoft  BASIC; 
and  (for  numbers  greater  than  32,767)  the  complementary  decimal 
value  for  use  in  Apple  Integer  BASIC. 


Page  $00 

Table  B-1  lists  the  zero  page  addresses  in  hexadecimal  and  decimal 
form,  followed  by  symbols  denoting  the  firmware  or  system 
software  that  uses  them. 

D  M  denotes  the  monitor. 

n  A  denotes  Applesoft  BASIC. 

n  /  denotes  Integer  BASIC. 

n  D  denotes  DOS  3.3. 

a  P  denotes  ProDOS.  Locations  whose  contents  ProDOS  saves  and 

restores  afterward  have  a  P  in  parentheses,  indicating  that 

ProDOS  has  no  net  effect  on  them. 
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Table  B- 

1 

Page  $00  use 

Hex 

Dec 

Used  by 

Hex 

Dec 

Used  by 

$00 

0 

A 

$30 

48 

M 

$01 

1 

A 

$31 

49 

M 

$02 

2 

A 

$32 

50 

M 

$03 

3 
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$33 

51 

M 
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4 
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$34 

52 

M 

$05 

5 
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$35 

53 

M 

D 

$06 

6 

$36 

54 

M 

D 

$07 

7 

$37 

55 

M 

D 

$08 

8 

$38 

56 

M 

D 

$09 

9 

$39 

57 

M 

D 

$0A 

10 

A 

$3A 

58 

M 

P 

$0B 

11 

A 

$3B 

59 

M 

P 

$0C 

12 

A 

$3C 

60 

M 

P 

$0D 

13 

A 

$3D 

61 

M 

P 

$0E 

14 

A 

$3E 

62 

M 

D  P 

$0F 

15 

A 

$3F 

63 

M 

D  P 

$10 

16 

A 

$40 

64 

M 
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$11 

17 

A 

$41 

65 

M 
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$12 

18 
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66 

M 

D  (P) 

$13 

19 

A 

$43 

61 

M 

D  (P) 

$14 

20 

A 

%44 

68 

M 

D  (P) 

$15 

21 

A 

$45 

69 

M 

D  (P) 
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22 

A 

%46 

70 

M 

D  (P) 

$17 

23 

A 

$47 

71 

M 

D  (P) 
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24 

A 

$48 

72 

M 

D  (P) 

$19 

25 

$49 

73 

M 

(P) 

$1A 

26 

$4A 

74 
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D  (P) 

$1B 

27 

$4B 

75 
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D  (P) 

$1C 

28 

$4C 

76 

I 

D  (P) 

$1D 

29 

$4D 

11 

I 

D  (P) 

$1F 

31 

$4F 

79 

M 

$25 

37 

M 

$55 

85 

M  A 

$26 

38 

M 

D 

$56 

86 

A 

$27 

39 

M 

D 

$57 

87 

A 

$28 

40 

M 

D 

$58 

88 

A 

$29 

41 

M 

D 

$59 

89 

A 

$2A 

42 

M 

D 

$5A 

90 

A 

$2B 

43 

M 

D 

$5B 

91 

A 

$2C 

44 

M 

D 

$5C 

92 

A 

$2D 

45 

M 

D 

$5D 

93 

A 

$2E 

46 

M 

D 

$5E 

94 

A 

$2F 

41 

M 

D 

$5F 

95 

A 

Page  $00  309 


Table  B 

-1  (continued) 

Page  $00  use 

Hex 

Dec 

Used  by 

Hex 

Dec 

Used  by 

$60 

96 

A 

$90 

144 

A  I 

$61 

97 

A 

$91 

145 

A  I 

$62 

98 

A 

$92 

146 

A  I 

$63 

99 

A 

$93 

147 

A  I 

$64 

100 

A 

$94 

148 

A  I 

$65 

101 

A 

$95 

149 

A  I 

$66 

102 

A 

$96 

150 

A  I 

$67 

103 

A 

I  D 

$97 

151 

A  I 

$68 

104 

A 

I  D 

$98 

152 

A  I 

$69 

105 

A 

I  D 

$99 

153 

A  I 

$6A 

106 

A 

I  D 

$9A 

154 

A  I 

$6b 

107 

A 

$9B 

155 

A  I 

$6C 

108 

A 

$9C 

156 

A  I 

$6d 

109 

A 

$9D 

157 

A  I 

$6e 

110 

A 

$9E 

158 

A  I 

$6f 

111 

A 

I  D 

$9F 

159 

A  I 

$70 

112 

A 

I  D 

$A0 

160 

A  I 

$71 

113 

A 

$A1 

161 

A  I 

$72 

114 

A 

$A2 

162 

A  I 

$73 

115 

A 

$A3 

163 

A  I 

$74 

116 

A 

$A4 

164 

A  I 

$75 

117 

A 

$A5 

165 

A  I 

$76 

118 

A 

$A6 

166 

A  I 

$77 

119 

A 

$A7 

167 

A  I 

$78 

120 

A 

$A8 

168 

A  I 

$79 

121 

A 

$A9 

169 

A  I 

$7A 

122 

A 

$AA 

170 

A  I 

$7B      ' 

123 

A 

$AB 

171 

A  I 

$7C 

124 

A 

$AC 

172 

A  I 

$7D 

125 

A 

$AD 

173 

A  I 

$7E 

126 

A 

$AE 

174 

A  I 

$7F 

127 

A 

$AF 

175 

A  I  D 

$80 

128 

A 

$B0 

176 

A  I  D 

$81 

129 

A 

$B1 

177 

A  I 

$82 

130 

A 

$B2 

178 

A  I 

$83 

131 

A 

$B3 

179 

A  I 

$84 

132 

A 

$B4 

180 

A  I 

$85 

133 

A 

$B5 

181 

A  I 

$86 

134 

A 

$B6 

182 

A  I 

$87 

135 

A 

$B7 

183 

A  I 

$88 

136 

A 

$B8 

184 

A  I 

$89 

137 

A 

$B9 

185 

A  I 
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Table  B 

-1  (continued) 

Page  $00  use 

Hex 

Dec 

Used  by 

Hex 

Dec 

Used  by 

$8A 

138 

A  I 

$BA 

186 

A  I 

$8B 

139 

A  I 

$BB 

187 

A  I 

$8C 

140 

A  I 

$BC 

188 

A  I 

$8D 

141 

A  I 

$BD 

189 

A  I 

$8E 

142 

A  I 

$BE 

190 

A  I 

$8F 

143 

A  I 

$BF 

191 

A  I 

$C0 

192 

A  I 

$E0 

224 

A 

$C1 

193 

A  I 

$E1 

225 

A 

$C2 

194 

A  I 

$E2 

226 

A 

$C3 

195 

A  I 

$E3 

227 

$C4 

196 

A  I 

$E4 

228 

A 

$C5 

197 

A  I 

$E5 

229 

A 

$C6 

198 

A  I 

$e6 

230 

A 

$C7 

199 

A  I 

$E7 

231 

A 

$C8 

200 

A  I 

$E8 

232 

A 

$C9 

201 

A  I 

$E9 

233 

A 

$CA 

202 

A  I  D 

$EA 

234 

A 

$CB 

203 

A  I  D 

$EB 

235 

$CC 

204 

A  I  D 

$EC 

236 

$CD 

205 

A  I  D 

$ED 

237 

$CE 

206 

I 

$EE 

238 

$CF 

207 

I 

$EF 

239 

$D0 

208 

A  I 

$F0 

240 

A 

$D1 

209 

A  I 

$F1 

241 

A 

$D2 

210 

A  I 

$F2 

242 

A 

$D3 

211 

A  I 

$F3 

243 

A 

$D4 

212 

A  I 

$F4 

244 

A 

$D5 

213 

A  I 

$F5 

245 

A 

$D6 

214 

I 

$F6 

246 

A 

$D7 

215 

I 

$F7 

247 

A 

$D8 

216 

A  I  D 

$F8 

248 

A 

$D9 

217 

A  I 

$F9 

249 

$DA 

218 

A  I 

$FA 

250 

$DB 

219 

A  I 

$FB 

251 

$DC 

220 

A  I 

$FC 

252 

$DD 

221 

A  I 

$FD 

253 

$DE 

222 

A  I 

$FE 

254 

$DF 

223 

A  I 

$FF 

255 
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Page  $03 


Most  of  page  $03  is  available  for  small  machine-language 
programs.  The  built-in  Monitor  uses  the  top  16  addresses  of 
page  $03,  as  shown  in  Figure  B-2;  the  XFer  routine  uses  locations 
$03ED  and  $03EE.  If  you  are  using  DOS  or  ProDOS,  it  also  uses  the 
32  locations  $03D0  through  $03EF. 


Table  B-2 

Page  $03  use 


Hex 


Dec 


Use 


$03F0 
$03F1 

$03F2 
$03F3 
$03F4 

$03F5 
$03F6 
$03F7 

$03F8 
$03F9 
$03FA 

$03FB 
$03FC 
$03FD 

$03FE 
$03FF 


1008 
1009 

1010 
1011 
1012 

1013 
1014 
1015 

1016 
1017 
1018 

1019 
1020 
1021 

1022 
1023 


Address  of  BRK  request  handler  (normally  $59, 
$FA) 

Reset  vector 

Power-up  byte  (see  text) 

Jump  instruction  to  Applesoft  &-command 
handler  (initially  $4C,  $58,  $FF) 


Jump  instmction  to  user  Control-Y  command 
handler 


Jump  instruction  to  NMI  Interrupt  handler 
(not  used  by  Apple  lie) 

Address  of  user  IRQ  interrupt  handler 


Screen  holes 

One  result  of  the  way  the  Apple  lie  hardware  maps  display  memory 
on  the  screen  is  that  groups  of  8  memory  addresses  are  left  over  in 
16  areas  of  the  text  and  low-resolution  display  pages — 8  areas  in 
main  RAM  and  8  in  auxiliary  RAM.  The  firmware  uses  for  these 
128  bytes  are  shown  in  Tables  B-3  and  B-4. 
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Memory  expansion 


The  version  of  the  Apple  lie  that  supports  the  memory 
expansion  card  uses  some  of  the  screen  holes  differently  than 
earlier  versions.  Where  they  differ,  the  memory  expansion  ROM 
assignments  are  given  in  parentheses  In  Tables  B-3  and  B-4 
following  the  original  and  UniDisk  3.5  assignments. 


Table  B-3 

IVIain  memory  screen  hole  allocations 


Hex 


Dec         Description 


Mouse  port:  low  byte  of  clamping  minimum 

Reserved  for  serial  port  1 

Reserved  for  serial  port  2 

Reserved 

Low  byte  of  X  coordinate  (Reserved) 

Reserved  for  mouse  port 

Reserved 

Reserved  (Low  byte  of  X  coordinate) 


$0478 

1144 

$0479 

1145 

$047A 

1146 

$047B 

1147 

$047C 

1148 

$047D 

1149 

$047E 

1150 

$047F 

1151 

$04F8 

1272 

$04F9 

1273 

$04FA 

1274 

$04FB 

1275 

$04FC 

1276 

$04FD 

1277 

$04FE 

1278 

$04FF 

1279 

$0578 

1400 

$0579 

1401 

$057A 

1402 

$057B 

1403 

$057C 

1404 

$057D 

1405 

$057E 

1406 

$057F 

1407 

$05F8 

1528 

$05F9 

1529 

$05FA 

1530 

$05FB 

1531 

$05FC 

1532 

$05FD 

1533 

$05FE 

1534 

$05FF 

1535 

JVIouse  port:  low  byte  of  clamping  maximum 

Reserved  for  serial  port  1 

Reserved  for  serial  port  2 

Reserved 

Low  byte  of  Y  coordinate  (Reserved) 

Reserved  for  mouse  port 

Reserved 

Reserved  (Low  byte  of  Y  coordinate) 

Mouse  port:  high  byte  of  clamping  minimum 
Port  1  printer  width  (1-255;  0  =  unlimited) 
Port  2  line  length  (1-255;  0  =  unlimited) 
Cursor  horizontal  position  (80-column  display) 
High  byte  of  X  coordinate  (Reserved) 
Reserved  for  mouse  port 
Reserved 
Reserved  (High  byte  of  X  coordinate) 

Mouse  port:  high  byte  of  clamping  maximum 

Port  1  temporary  storage  location 

Port  2  temporary  storage  location 

Reserved 

High  byte  of  Y  coordinate  (Reserved) 

Reserved  for  mouse  port 

Reserved 

Reserved  (High  byte  of  Y  coordinate) 


Screen  holes 
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Table  B-3  (continued) 

Main  memory  screen  hole  allocations 


Hex 


Dec         Description 


Reserved 

Indicates  wtien  port  1  firmware  is  parsing  a 

command 

Indicates  when  port  2  firmware  is  parsing  a 

command 

Reserved 

Mouse  port:  reserved  (Reserved) 

Reserved  for  mouse  port 

Reserved 

Reserved  (Mouse  port:  reserved) 

Reserved 

Current  port  1  command  character 

Current  port  2  command  character 

Reserved 

Mouse  port:  reserved  (Reserved) 

Reserved  for  mouse  port 

Reserved 

Reserved  (Mouse  port:  reserved) 

DEVNO:  $nO  =  current  active  port  number  x  16 

Port  1  flags  for  echo  and  auto  line  feed 

Port  2  flags  for  each  and  auto  line  feed 

Reserved 

Mouse  port  status  byte  (Reserved) 

Reserved  for  mouse  port 

Reserved 

Reserved  (Mouse  port  status  byte) 

MSLOT:  owner  of  $C800-$CFFF  ($C3,  video) 

Port  1  current  printer  column 

Port  2  current  line  position 

Reserved 

Mouse  port  mode  byte  (Reserved) 

Reserved  for  mouse  port 

Reserved 

Reserved  (Mouse  port  mode  byte) 


$0678 

1656 

$0679 

1657 

$067A 

1658 

$067B 

1659 

$067C 

1660 

$067D 

1661 

$067E 

1662 

$067F 

1663 

$06F8 

1784 

$06F9 

1785 

$06fa 

1786 

$06fb 

1787 

$06FC 

1788 

$06fd 

1789 

$o6fe 

1790 

$06ff 

1791 

$0778 

1912 

$0779 

1913 

$077A 

1914 

$077B 

1915 

$077C 

1916 

$077D 

1917 

$077E 

1918 

$077F 

1919 

$07F8 

2040 

$07F9 

2041 

$07FA 

2042 

$07FB 

2043 

$07FC 

2044 

$07FD 

2045 

$07FE 

2046 

$07FF 

2047 
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Table  B-4 

Auxiliary  memory  screen  hole  aiiocatior^s 


Hex 


Dec       Description 


$0478 

1144 

Initial  port  1 

$0479 

1145 

Initial  port  1 

$047A 

1146 

Initial  port  1 

$047B 

1147 

Initial  port  1 

$047C 

1148 

Initial  port  2 

$047D 

1149 

Initial  port  2 

$047E 

1150 

Initial  port  2 

$047F 

1151 

Initial  port  2 

$04F8 

1272 

through 

Reserved 

$04FF 

1279 

$0578 

1400 

through 

Reserved 

$057F 

1407 

$05F8 

1528 

through 

Reserved 

$05FF 

1535 

$0678 

1656 

through 

Reserved 

$067F 

1663 

$06F8 

1784 

through 

Reserved 

$06ff 

1791 

$0778 

1912 

through 

Reserved 

$077F 

1919 

$07F8 

2040 

through 

Reserved 

$07FF 

2047 

ACIA  control  register  values  ($9E) 
ACIA  command  register  values  ($0B) 
characteristics  flags  ($40) 
printer  width  ($50) 
ACIA  control  register  values  ($l6) 
ACIA  command  register  values  ($0B) 
characteristics  flags  ($01) 
line  length  ($00) 


Screen  Inoles 
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The  hardware  page 

Tables  B-5  through  B-9  list  all  the  hardware  locations  available  for 
use  in  the  Apple  lie.  These  tables  have  a  column  at  the  left  that  is  not 
present  in  other  tables.  This  column,  labeled  RW,  indicates  the 
action  to  take  at  a  particular  location. 

n  R  means  read. 

n  RR  means  read  twice  in  succession. 

a  J?7  means  read  the  byte  and  then  check  bit  7;  in  the  use  column, 
"See  if..."  refers  to  the  condition  represented  by  bit  7  =  1,  unless 
otherwise  specified.  Bit  7  has  a  value  of  $80,  so  if  the  contents  of 
the  location  are  greater  than  or  equal  to  $80,  the  bit  is  on. 

Another  way  to  test  bit  7  (the  sign  bit)  is  with  a  BIT  instruction, 
followed  by  BPL  (bit  7  was  0)  or  BMI  (bit  7  was  1). 

n  i^VT  means  to  either  read  or  write.  For  writing,  the  value  is 
unimportant. 

n    VT  means  to  write  only.  The  value  is  unimportant. 

D  N  means  not  to  read  or  write,  because  the  location  is  reserved. 

An  address  of  the  form  $C00x  refers  to  the  l6  locations  from  $C000 
through  $C00F.  Labels,  when  they  are  shown,  are  simply  memory 
aids.  Some  of  them  correspond  to  the  labels  at  those  addresses  in 
the  firmware,  others  do  not.  Your  program  wiU  have  to  assign  a 
label  for  it  anyway. 


Table  B-5 

Addresses  $C000-$C03F 


RW 


Hex 


Dec 


Neg  dec       Label 


Use 


R 

$C00x 

KStrb 

W 

$C000 

49152 

-16384 

SOStore 

W 

$C001 

49153 

-16383 

SOStore 

W 

$C002 

49154 

-16382 

RAMRd 

W 

$C004 

49156 

-16380 

RAMWrt 

W 

$C005 

49157 

-16379 

RAMWrt 

W 

$C006 

49158 

-16378 

W 

$C007 

49159 

-16377 

w 

$C008 

49160 

-16376 

AltZP 

w 

$C009 

49161 

-16375 

AltZP 

w 

$C00A 

49162 

-16374 

w 

SCOOB 

49163 

-16373 

w 

$C00C 

49164 

-16372 

80Col 

Read  keyboard  data  (bits  0-6)  and  strobe  (bit  7) 

Off:  Page2  switches  Page  1  and  2 

On:  Page2  switches  Page  1  and  IX 

Off:  Read  main  48K  RAM 

Off:  Write  in  main  48K  RAM 

On:  Write  in  auxiliary  48K  RAM 

Reserved 

Reserved 

Off:  Use  main  PO,  PI,  bank-switched  RAM 

On:  Use  auxiliary  PO,  PI,  bank-switched  RAM 

Reserved 

Reserved 

Off:  40-column  display 
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Table  B-5  (continued) 
Addresses  $C000-$C03F 


Hex 


Dec 


Neg  dec       Label 


Use 


$COOD  49165 
$COOE  49166 
$COOF         49167 


$C01x 

$C010 

$C011 

$C012 

$C013 

$C014 

$C015 

$C016 

$C017 

$C018 

$C019 

$C01A 

$C01B 

$C01C 

$C01D 

$C01E 

$C01F 

$C020 

through 

$C02F 

$C030 
$C030 


49168 
49169 
49170 
49171 
49172 
49173 
49174 
49175 
49176 
49177 
49178 
49179 
49180 
49181 
49182 
49183 


49200 
49200 


$C031        49201 

through 

$C03F        49215 


-16371 
-16270 
-16369 

-16368 
-16367 
-16366 
-16365 
-16364 
-16363 
-16362 
-16361 
-16360 
-16359 
-16358 
-16357 
-16356 
-16355 
-16354 
-16353 


49184       -16352 
49199       -16337 


-16336 
-16336 

-16335 
-16321 


8OC0I 

AltChar 

AltChar 

AKD 

RdBnk2 

RdLCRAM 

RdRAMRd 

RdRAMWrt 

RstXInt 

RdAltZP 

RstYInt 

RdSOStore 

RstVBl 

RdTEXT 

RdMIXED 

RdPage2 

RdHiRes 

RdAltChar 

RdSOCol 


Reserved 


On:  80-colunin  display 

Off:  Display  primary  character  set 

On:  Display  alternate  character  set 

Clear  keyboard  strobe  ($C00x  bit  7) 

See  if  any  key  now  down;  clear  strobe 

See  if  using  $D000  bank  2  (or  1) 

See  if  reading  RAM  (or  ROM). 

See  if  reading  auxiliary  48K  RAM  (or  main) 

See  if  writing  auxiliary  48K  RAM  (or  main) 

Reset  mouse  XO  interrupt 

See  if  auxiliary  PO,  PI  and  bank-switched  RAM 

Reset  mouse  Y  interrupt 

See  if  80Store  on  (or  ofi) 

See  if  VBlInt  off  (1);  reset  it 

See  if  text  (or  graphics) 

See  if  mixed  mode  switch  on 

See  if  Page  2/lX  selected  (or  1) 

See  if  high-resolution  switch  on 

See  if  alternate  character  set  (or  primary) 

See  if  80-column  hardware  on 

Reserved  (read  and  write) 


Toggle  speaker 


Reserved  (read  and  write) 


The  hardware  page 


317 


Table  B-6 

Addresses  $C040-$C05F 

RW 

Hex 

Dec 

Neg  dec 

Label 

Use 

R7 

$C040 

49216 

-16320 

RdXYMsk 

SeeifXO/YOmaskset 

R7 

$C041 

49217 

-16319 

RdVBlMsk 

See  if  VBL  mask  set 

R7 

$C042 

49218 

-16318 

RdXOEdge 

See  if  interrupt  on  falling  XO  edge 

R7 

$C043 

49219 

-16317 

RdYOEdge 

See  if  interrupt  on  falling  YO  edge 

N 

$C044 

49220 

-16316 

Reserved 

N 

$C045 

49221 

-16315) 

Reserved 

N 

$C046 

49222 

-16314 

Reserved 

N 

$C047 

49223 

-16313 

Reserved 

R 

$C048 

49224 

-16312 

RstXY 

Reset  XO/YO  interrupt  flags 

N 

$C049 

49225 

-16311 

Reserved 

N 

$C04A 

49226 

-16310 

Reserved 

N 

$C04B 

49227 

-16309 

Reserved 

N 

$C04C 

49228 

-16308 

Reserved 

N 

$C04D 

49229 

-16307 

Reserved 

N 

$C04E 

49230 

-16306 

Reserved 

N 

$C04F 

49231 

-16305 

Reserved 

R/W 

$C050 

49232 

-16304 

TEXT 

Off:  Graphics  display 

R/W 

$C051 

49233 

-16303 

TEXT 

On:  Text  display 

R/W 

$C052 

49234 

-16302 

MIXED 

Off:  Text  or  graphics  only 

R/W 

$C053 

49235 

-16301 

MIXED 

On:  Combination  text  and  graphics 

R/W 

$C054 

49236 

-16300 

Page2 

Off:  Use  Page  1 

R/W 

$C055 

49237 

-16299 

Page2 

On:  Display  Page  2  (80Store  ofO;  store  to  Page 
IX  (80Store  on) 

R/W 

$C056 

49238 

-16298 

HiRes 

Off:  Low  resolution 

R/W 

$C057 

49239 

-16297 

HiRes 

On:  High  resolution;  double  if  8OC0I  and 
DHiRes  on 

N 

$C058 

49240 

-16296 

Reserved  if  lOUDis  on  ($C07E  bit  7=1) 

R/W 

DisX 

Disable  (mask)  mouse  XO/YO  interrupts 

N 

$C059 

49241 

-16295 

Reserved  if  lOUDis  on 

R/W 

EnbXY 

Enable  (allow)  mouse  XO/YO  interrupts 

N 

$C05A 

49242 

-16294 

Reserved  if  lOUDis  on 

R/W 

DisVBl 

Disable  (mask)  VBL  interrupts 

N 

$C05B 

49243 

-16293 

Reserved  if  lOUDis  on 

R/W 

EnVBl 

Enable  (allow)  VBL  interrupts 

N 

$C05C 

49244 

-16292 

Reserved  if  lOUDis  on 

R/W 

XOEdge 

Interrupt  on  rising  edge  of  XO 

N 

$C05D 

49245 

-1629 

Reserved  if  lOUDis  on 

R/W 

XOEdge 

Interrupt  on  falling  edge  of  XO 

R/W 

$C05E 

49246 

-16290 

DHiRes 

If  lOUDis  on:  Set  double  high-resolution 

R/W 

YOEdge 

If  lOUDis  off:  Intermpt  on  rising  YO 

R/W 

$C05F 

49247 

-16289 

DHiRes 

If  lOUDis  on:  Clear  double  high-resolution 

R/W 

YOEdge 

If  lOUDis  off:  Intermpt  on  falUng  YO 
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Table  B-7 

Addresses  $C060-$C07F 


Hex 


Dec 


Neg  dec       Label 


Use 


$C06x 

$C060 

4924 

-16288 

RdSOSw 

$C06l 

49249 

-16287 

RdBtnO 

$C062 

49250 

-16286 

RdBtnl 

$C063 

49251 

-16285 

Rd63 

$C064 

49252 

-16284 

PdlO 

$C065 

49253 

-16283 

Pdll 

$C066 

49254 

-16282 

MouXl 

$C067 

49255 

-16281 

MouYl 

$C068 

49256 

-16280 

through 

$C06F 

49263 

-16273 

Reserved  (write) 

See  if  80/40  switch  down  (=  40) 

See  if  mouse  button/Open-Apple  pressed 

See  if  switch  1/Solid  Apple  pressed 

See  if  mouse  button  not  pressed 

See  if  hand  control  button  0  pressed 

See  if  hand  control  button  1  pressed 

See  if  mouse  XI  (direction)  is  high 

See  if  mouse  Yl  (direction)  is  high 

Reserved  (w^rite  and  read) 


$C07x 


$C070 
$C071 
through 
$C07D 

49264 
49265 

49277 

-16272 
-16271 

-16259 

PTrig 

$C07E 

49278 

-16258 

RdlOUDis 
lOUDis 

$C07F 

49279 

-16257 

RdDHiRes 
lOUDis 

Trigger  paddle  timer;  reset  VBlInt; 
however,  some  $C07x  are  reserved 
Designated  trigger  or  reset  location 

Reserved 


See  if  lOUDis  on;  trigger  paddle  timer; 

reset  VBlInt 

On:  Enable  access  to  DHiRes  switch; 

disable  $C058-$C05F  lOU  access 

See  if  DHiRes  on 

Off:  Disable  access  to  DHiRes  switch; 

enable  $C058-$C05F  lOU  access 
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Table  B-8 

Addresses  $C080-$C0AF 

RW 

Hex 

Dec 

Neg  dec       Label 

Use 

R 

$C080 

49280 

-16256 

Read  RAM;  no  write;  use  $D000  bank  2 

RR 

$C081 

49281 

-16255 

Read  ROM;  write  RAM;  use  $D000  bank  2 

R 

$C082 

49282 

-16254 

Read  ROM;  no  write;  use  $D000  bank  2 

RR 

$C083 

49283 

-16253 

Read  and  write  RAM;  use  $D000  bank  2 

N 

$C084 

49284 

-16252 

Reserved 

N 

$C085 

49285 

-16251 

Reserved 

N 

$C086 

49286 

-16250 

Reserved 

N 

$C087 

49287 

-16249 

Reserved 

R 

$C088 

49288 

-16248 

Read  RAM;  no  write;  use  $D000  bank  1 

RR 

$C089 

49289 

-16247 

Read  ROM;  write  RAM;  use  $D000  bank  1 

R 

$C08A 

49290 

-16246 

Read  ROM;  no  write;  use  $D000  bank  1 

RR 

$C08B 

49291 

-16245 

Read  and  write  RAM;  use  $D000  bank  1 

N 

$C08C 

49292 

-16244 

Reserved 

N 

$C08D 

49293 

-16243 

Reserved 

N 

$C08E 

49294 

-16242 

Reserved 

N 

$C08F 

49295 

-16241 

Reserved 

N 

$C090 
through 

49296 

-16240 

Reserved 

N 

$C097 

49303 

-16233 

R/W 

$C098 

49304 

-16232 

Port  1  ACIA  transmit/receive  register 

R/W 

$C099 

49305 

-16231 

Port  1  ACIA  status  register 

R/W 

$C09A 

49306 

-16230 

Port  1  ACIA  command  register 

R/W 

$C09B 

49307 

-16229 

Port  1  ACLA.  control  register 

N 

$C09C 
through 

49308 

-16228 

Reserved 

N 

$C09F 

49311 

-16225 

N 

$COAO 
through 

49312 

-16224 

Reserved 

N 

$C0A7 

49319 

-16217 

R/W 

$C0A8 

49320 

-16216 

Port  2  ACIA  transmit/receive  register 

R/W 

$C0A9 

49321 

-16215 

Port  2  ACIA.  status  register 

R/W 

$COAA 

49322 

-16214 

Port  2  ACIA  command  register 

R/W 

$COAB 

49323 

-16213 

Port  2  ACIA  control  register 

N 

$COAC 
through 

49324 

-16212 

Reserved 

N 

$COAF 

49327 

-16209 
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Table  B-9 

Addresses  $COBO-$COFF 


RW 


Hex 


Dec 


Neg  Dec       Label 


Use 


N 
N 

$COBO 

through 

$COBF 

49328 
49343 

-16208 
-16193 

N 
N 

$COCO 

through 

$COCF 

49344 
49359 

-16192 
-16177 

N 
N 

$CODO 

through 

$CODF 

49360 
49375 

-16176 
-16161 

N 
N 

$COEO 

through 

$COEF 

49376 
49391 

-16160 
-16145 

N 
N 

$COFO 

through 

$COFF 

49392 
49407 

-16144 
-16129 

Reserved 


Reserved 


Reserved 


Reserved 


Reserved 
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Appendix  C 


Important  Firmware  Locations 


This  appendix  lists  all  significant  firmware  addresses:  entry  points, 
locations  containing  the  addresses  of  entry  points,  and  locations 
where  machine  and  device  identification  bytes  reside. 


Warning      The  Monitor  firmware  entry  points  are  the  only  published  entry 
points  in  the  sense  that  they  are  the  only  ones  that  will  remain 
in  the  same  iocations  in  future  Apple  II  series  computers. 

The  firmware  protocol  Identification  bytes  and  offsets  will  worl< 
with  other  Apple  ll-series  computers  only  if  used  as  directed. 


The  tables 

This  appendix  supplements  the  chapter  text  by  specifying  three 
forms  of  each  address:  hexadecimal,  decimal,  and  complementary 
(negative)  decimal. 

In  these  tables,  some  of  the  addresses  are  followed  by  a  label.  These 
labels  are  listed  only  to  help  you  find  the  named  location  in  the 
firmware  listings,  or  to  remember  the  function  found  at  the  address. 
The  Apple  lie  contains  no  global  label  table:  your  program  must 
assign  its  own  labels  to  the  addresses  as  required. 
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There  are  several  types  of  information  at  these  firmware  addresses: 
actual  entry  points  (labeled  entry),  the  low-order  byte  of  an  entry 
point  (labeled  offset),  a  device  or  machine  identification  byte 
Oabeled  ident),  and  indicators  Oabeled  indie)  specifying  whether 
there  are  optional  routines,  vector  addresses  (labeled  vector),  or 
an  RTS  instruction  location. 

Each  input/output  port  has  an  associated  protocol  table,  as  shown 
in  Tables  C-1  through  C-4.  Many  of  the  bytes  Oabeled  offset)  in  the 
protocol  tables  are  the  low-order  bytes  of  addresses  of  I/O  routines 
for  the  ports;  the  high-order  byte  of  these  addresses  must  be  $Cn 
(where  n  is  the  port  number).  This  structure  is  explained  in 
Chapter  3.  Although  your  program  must  perform  some  extra 
processing  to  use  these  tables,  the  benefit  is  simplified  compatible 
port  and  slot  I/O  for  all  Apple  Il-series  machines. 


Port  addresses 

Addresses  for  serial  ports  1  and  2,  output  port  3,  and  mouse  input 
port  4  are  shown  in  the  following  four  tables. 


Table  C-1 

Serial  port  1  addresses 


Hex 


Dec 


Neg  dec         Label 


Type 


Description 


$C100 

49408 

-16128 

$C105 

49413 

-16123 

$C107 

49415 

-16121 

$C10B 

49419 

-16117 

$C10C 

49420 

-16116 

$C10D 

49421 

-16115 

$C10E 

49422 

-16114 

$C10F 

49423 

-16113 

$C110 

49424 

-16112 

$C111 

49425 

-16111 

entry  Main  port  1  entry  point 

ident  ID  byte  ($38) 

ident  ID  byte  ($18) 

ident  Firmware  card  signature  ($01) 

ident  Super  Serial  Card  ID  ($31) 

offset  Low-order  PInit  address 

offset  Low-order  PRead  address 

offset  Low-order  PWrite  address 

offset  Low-order  PStatus  address 

indie  Non-zero:  no  optional  routines 


Port  addresses 
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Table  C-2 

Serial  port  2  addresses 


Hex 

Dec 

Neg  dec         Label 

Type 

Description 

$C200 

49664 

-15872 

entry 

Main  port  2  entry  point 

$C205 

49669 

-15867 

iden 

ID  byte  ($38) 

$C207 

49671 

-15865 

ident 

ID  byte  ($18) 

$C20B 

49675 

-15861 

ident 

Firmware  card  ID  ($01) 

$C20D 

49676 

-15860 

ident 

Super  Serial  Card  ID  ($31) 

$C20D 

49677 

-15859 

offset 

Low-order  PInit  address 

$C20E 

49678 

-15858 

offset 

Low-order  PRead  address 

$C20F 

49679 

-15857 

offset 

Low-order  PWrite  address 

$C210 

49680 

-15856 

offset 

Low-order  PStatus  address 

$C211 

49681 

-15855 

indie 

Non-zero:  no  optional  routines 

Table  C-3 

Video  firmware  addresses 

Hex 

Dec 

Neg  Dec         Label 

Type 

Description 

$C300 

49920 

-15616 

entry 

$C305 

49925 

-15611 

C3KeyIn 

ident 

$C307 

49927 

-15609 

C3COutl 

ident 

$C30B 

49931 

-15605 

ident 

$C30C 

49932 

-15604 

ident 

$C30D 

49933 

-15603 

offset 

$C30E 

49934 

-15602 

offset 

$C30F 

49935 

-15601 

offset 

$C310 

49936 

-15600 

offset 

$C311 

49937 

-15599 

MoveAux 

entry 

Main  video  entry  point  (output  only) 
ID  byte  ($38) 
ID  byte  ($18) 

Firmware  card  signature  ($01) 
80-column  card  ID  ($88) 
Low-order  PInit  address 
Low-order  PRead  address 
Low-order  PWrite  address 
Low-order  PStatus  address 
Routine  for  main/auxiliary  control 
swapping  (also  called  AuxMove) 
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Table  C-4 

Mouse  port  addresses 


Dec 


Neg  dec         Label 


Type 


Description 


50176 

-15360 

entry 

50181 

-15355 

ident 

50183 

-15353 

ident 

50187 

-15349 

ident 

50188 

-15348 

type 

50189 

-15347 

offset 

50190 

-15346 

offset 

50191 

-15345 

offset 

50192 

-15344 

offset 

50193 

-15343 

indie 

50194 

-15342 

,  SetMouse 

offset 

50195 

-15341 

ServeMouse 

offset 

50196 

-15340 

ReadMouse 

offset 

50197 

-15339 

ClearMouse 

offset 

50198 

-15338 

PosMouse 

offset 

50199 

-15337 

ClampMouse 

offset 

50200 

-15336 

HomeMouse 

offset 

50201 

-15335 

InitMouse 

offset 

Main  mouse  entry  point 
ID  byte  ($38) 
ID  byte  ($18) 

Firmware  card  signature  ($01) 
X-Y  pointing  device  ID  ($20) 
Low-order  PInit  address 
Low-order  PRead  address 
Low-order  PWrite  address 
Low-order  PStatus  address 
Optional  routines  follow  ($00) 
Low-order  SetMouse  address 
Low-order  ServeMouse  address 
Low-order  ReadMouse  address 
Low-order  ClearMouse  address 
Low-order  PosMouse  address 
Low-order  ClampMouse  address 
Low-order  HomeMouse  address 
Low-order  InitMouse  address 


Memory  expansion 


The  memory  expansion  version  of  the  Apple  lie  supports  the 
mouse  in  port  7.  This  means  that  the  firmware  entry  points  are 
$C7XX  addresses,  instead  of  $C4XX  address;  change  the  4's  to 
7's  in  Table  C-4. 


Port  addresses 
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other  video  and  I/O  firmware  addresses 

Miscellaneous  firmware  addresses  are  listed  in  Table  C-5. 


Table  C-5 

Apple  lie  enhanced  video  and  miscellaneous  firmware 


Hex 

Dec 

Neg  dec 

Label 

Type 

Description 

$C600 
$C700 
$C803 

50688         -14848 
50944          -14592 
51203          -14333 

Memory  expansion 

NewIRQ 

entry 
entry 
entry 

Disk  drive  firmware  entry  point 
External  disk  startup  routine 
IRQ  handling  routine 

$C700  supports  the  mouse 

>  In  the  memory  expansion  version. 

Applesoft  BASIC  interpreter  addresses 

The  addresses  of  Applesoft  BASIC  entry  points  are  listed  in  the 
Applesoft  BASIC  Programmer's  Reference  Manual.  The  Applesoft 
interpreter  occupies  ROM  addresses  from  $D000  through  $F7FF. 


Monitor  addresses 

Table  C-6  lists  the  Monitor  entry  points,  machine  identifier  bytes, 
interrupt  vectors,  and  the  address  of  a  known  RTS  instruction. 


Table  C-6 

Apple  He  monitor  entry  points  and  vectors 


Hex 


Dec 


Neg  dec         Label 


Type 


Description 


$F800 

63488 

-2048 

PLOT 

entry 

$F819 

63513 

-2023 

HLine 

entry 

$F828 

63528 

-2008 

VLine 

entry 

$F832 

63538 

-1998 

ClrScr 

entry 

$F836 

63542 

-1994 

ClrTop 

entry 

$F864 

63588 

-1948 

SetCol 

entry 

$F871 

63601 

-1935 

SCRN 

entry 

$F941 

63809 

-1727 

PrntAX 

entry 

$F94A 

63818 

-1718 

PrB12 

entry 

Plots  a  low-resolution  block 
Draws  low-resolution  horizontal  line 
Draws  low-resolution  vertical  line 
Clears  low-resolution  screen 
Clears  top  40  low-resolution  lines 
Sets  low-resolution  color  (Table  5-4) 
Reads  color  of  low-resolution  block 

Displays  A  and  X  in  hex 
Sends  X  blanks  to  output 
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Table  C-6  (continued) 

Apple  lie  monitor  entry  points  and  vectors 


Dec 


Neg  dec  Label 


Type 


Description 


63845 

-1691 

NewBRK 

entry 

64098 

-1438 

Reset 

entry 

64386 

-1150 

PRead 

entry 

(>AA<ol 

-1169 

SetPwrC 

entry 

64535 

-1101 

ident 

64548 

-1088 

idem 

64477 

-1059 

Belli 

entry 

64578 

-958 

ClrEOP 

entry 

64600 

-936 

HOME 

entry 

64668 

-868 

CIrEOL 

entry 

64670 

-866 

CIEOLZ 

entry 

64680 

-856 

WAIT 

entry 

64780 

-756 

RdKey 

entry 

64795 

-741 

Keyin 

entry 

64821 

-715 

RdChar 

entry 

64871 

-665 

GetLnZ 

entry 

64874 

-662 

GetLn 

entry 

64879 

^57 

GetLnl 

entry 

64907 

-629 

CROutl 

entry 

64910 

-626 

CROut 

entry 

64986 

-550 

PrByte 

entry 

64995 

-541 

PrHex 

entry 

65005 

-531 

COut 

entry 

65008 

-528 

COutl 

entry 

65068 

-468 

MOVE 

entry 

65078 

-458 

VERIFY 

entry 

65325 

-211 

PrErr 

entry 

65338 

-198 

Bell 

entry 

65343 

-193 

lORest 

entry 

65354 

-182 

lOSave 

entry 

65368 

-168 

lORTS 

RTS 

65385 

-151 

Monitor 

entry 

65530 

-6 

vector 

65531 

-5 

vector 

65532 

-4 

vector 

65533 

-3 

vector 

65534 

-2 

IRQVect 

vector 

65535 

-1 

vector 

Apple  lie  break  handler 
Hardware  reset  routine 

Reads  hand  controller  position 
Routine  to  create  power-up  byte 
Machine  identification  byte 
Machine  identification  byte 
Sends  l-kHz  beep  to  speaker 

Clears  from  cursor  to  bottom 
Clears  from  cursor  to  upper  left 
Clears  from  cursor  to  end  of  line 
Clears  from  BASL  to  end  of  line 
Delays  for  time  specified  by  A 

Displays  cursor,  jumps  to  KSW 
Waits  for  keypress,  reads  key 
Gets  input,  interprets  ESC  codes 
Sends  CR  to  output,  goes  to  GetLn 
Displays  prompt,  gets  input  line 
No  prompt;  gets  input  line 
Clears  to  end  of  line,  calls  CROut 
Sends  CR  to  output 
Sends  A  to  output 
Displays  low  nibble  of  A  in  hex 
Jumps  to  CSW 
Displays  A,  advances  cursor 

Copies  memory  elsewhere 
Compares  two  blocks  of  memory 

Sends  ERR  to  output;  beeps 
Sends  CONTROL-G  to  output 
Loads  $45-$49  into  registers 
Stores  A,  X,  Y,  P,  S  at  $45-$49 
Location  of  known  RTS  instruction 
Standard  Monitor  entry  point 

Low-order  NMI  vector  (unused) 
High-order  NMI  vector  (unused) 
Low-order  reset  vector  ($62) 
High-order  reset  vector  ($FA) 
Low-order  IRQ  vector  ($03) 
High-order  IRQ  vector  ($CB) 


Monitor  addresses 
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Appendix  D 

Operating  Systems 
and    Languages 


This  appendix  is  an  overview  of  the  characteristics  of  operating 
systems  and  languages  when  run  on  the  Apple  lie.  It  is  not  intended 
to  be  a  complete  description.  For  more  information,  refer  to  the 
manuals  that  are  provided  with  each  product. 


Operating  systems 

This  section  discusses  the  operating  systems  that  the  Apple  lie  works 
with  CP/M,  and  any  other  operating  system  that  requires  an 
interface  card,  does  not  work  on  the  Apple  lie. 


ProDOS 

ProDOS  is  the  preferred  disk  operating  system  for  the  Apple  lie.  It 
supports  startup  from  the  external  disk  drive  (on  original  Apple  He's 
with  the  command  PR#7),  interrupts,  and  all  other  hardware  and 
firmware  features  of  the  Apple  lie. 


DOS 

The  Apple  lie  works  with  DOS  3-3.  Its  built-in  disk  drive  hardware 
and  firmware  can  also  access  DOS  3.2  disks  by  using  the  BASICS 
disk.  DOS  support  is  provided  for  the  sake  of  Apple  II  series 
compatibility;  neither  version  of  DOS  takes  full  advantage  of  all  the 
features  of  the  Apple  lie. 
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Pascal  Operating  System 

Versions  1.2  and  later  of  the  Pascal  Operating  System  use  the 
80/40  switch  and  the  interrupt  features  of  the  Apple  lie,  while 
remaining  compatible  with  the  other  Apple  II  series  computers. 

While  the  Apple  lie  works  with  Pascal  1.1,  this  version  of  the  Pascal 
Operating  System  does  not  use  the  80/40  switch  or  handle 
interrupts. 

The  Apple  lie  does  not  work  with  Pascal  1.0,  because  the  I/O 
firmware  entry  points  of  that  version  of  the  operating  system  are 
rigidly  defined  (rather  than  being  accessed  via  a  table),  and  the 
Apple  He's  built-in  firmware  does  not  correspond  to  these  entry 
points. 


Languages 

This  section  discusses  using  Apple  programming  languages  with  the 
Apple  lie.  It  is  also  a  guide  to  using  this  reference  manual  with  these 
languages. 


Applesoft  BASIC 

The  programming  examples  in  this  manual  are  almost  entirely  in 
assembly  language,  and  so  most  addresses  and  values  are  given  in 
hexadecimal  notation. 

Use  a  PEEK  in  BASIC  (instead  of  LDA  in  assembly  language)  to  read 
a  location,  and  a  POKE  (instead  of  STA)  to  write  to  a  location.  The 
values  used  by  Applesoft  must  be  in  decimal,  so  you  will  have  to 
convert  hexadecimal  values  given  in  this  manual  to  decimal. 
(Several  tables  in  this  manual  include  decimal  equivalents  to  make 
the  job  easier  for  you.) 

If  you  read  a  hardware  address  from  a  BASIC  program,  you  get  a 
value  between  0  and  255.  Bit  7  has  a  value  of  128,  so  if  a  soft  switch  is 
on,  its  value  will  be  equal  to  or  greater  than  128;  if  the  switch  is  off, 
the  value  will  be  less  than  128. 
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Integer  BASIC 

You  will  have  to  mn  a  version  of  DOS  in  your  Apple  He  to  use 
Integer  BASIC.  ProDOS  does  not  support  Integer  BASIC. 


Pascal 

The  Pascal  language  runs  on  the  Apple  lie  under  versions  1.1  or 
later  of  the  Pascal  Operating  System.  However,  for  best 
performance,  use  Pascal  versions  1.2  or  later. 


Fortran 

Fortran  runs  under  version  1.1  of  the  Pascal  Operating  System, 
which  does  not  detect  or  use  certain  Apple  lie  features,  such  as  the 
80/40  switch  or  auxiliary  memory.  Therefore,  Fortran  does  not  take 
advantage  of  these  features  either. 


Logo  II 

Apple  Logo  n  works  under  ProEXDS  on  Apple  II  series  machines  with 
at  least  128K  of  memory.  Logo  II  is  a  version  of  the  Logo  language 
originally  developed  from  the  LISP  (LlSt  Processing)  language  at 
MIT  as  a  language  to  be  used  for  learning.  Logo  E  takes  advantage  of 
the  Apple  II's  graphics  and  retains  much  of  the  power  and  flavor  of 
LISP  without  LISP'S  somewhat  cryptic  syntax. 
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Appendix  E 


Interrupts 


This  appendix  describes  the  sources  of  interrupts  on  the  Apple  lie, 
how  the  firmware  handles  the  interrupts,  and  how  to  use  interrupt- 
driven  features  directly  in  those  rare  cases  when  the  firmware 
cannot  meet  your  needs. 


Warning      if  you  use  interrupt  hardware  directly,  instead  of  using  \he  built- 
in  interrupt-hiandling  firmware,  you  can't  be  sure  tiiat  your 
programs  will  be  compatible  witin  possible  future  Apple  II  series 
computers  or  revisions. 


Introduction 

This  section  describes  interrupts  and  their  effects  on  the  Apple  lie 
hardware. 


What  is  an  interrupt? 

An  interrupt  is  a  signal  that  a  computer  uses  to  know  when  to  stop 
what  it's  doing  so  it  can  quickly  handle  a  time-dependent  task.  For 
example,  the  Apple  lie  mouse  sends  an  interrupt  to  the  computer 
every  time  it  moves.  This  lets  the  system  keep  track  of  the  mouse's 
position  and  maintain  smooth  movement  of  the  pointer  on  the 
screen. 
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When  an  interrupt  occurs,  control  passes  to  an  interrupt  handler, 
which  must  record  the  exact  state  of  the  computer  at  the  moment  of 
the  interrupt,  determine  the  source  of  the  interrupt,  and  take 
appropriate  action.  It  is  important  that  the  computer  preserve  a 
"snapshot"  of  its  state  when  interrupted,  so  that  when  it  continues 
later  with  what  it  was  doing,  those  conditions  can  be  restored. 


Interrupts  on  Apple  II  computers 

Interrupts  have  not  always  been  fully  supported  on  the  Apple  II.  All 
versions  of  Apple's  DOS,  as  well  as  the  Morutor  program,  rely  on 
the  integrity  of  location  $45,  which  the  built-in  interrupt  handler 
has  always  destroyed  by  saving  the  accumulator  in  it.  Most  versions 
of  Pascal  simply  do  not  work  with  interrupts  enabled. 

The  Apple  lie  built-in  interrupt  handler  now  saves  the  accumulator 
on  the  stack  instead  of  in  location  $45.  DOS  3.3,  ProDOS, 
Pascal  1.2  (or  later  versions),  and  the  Monitor  all  work  with 
interrupts  on  the  Apple  lie. 

You  should  use  either  ProDOS  or  Pascal  1.2  (or  later  versions)  if 
you  want  interrupt-using  software  to  work  on  the  Apple  He  and  the 
Apple  II  Plus.  Both  operating  systems  have  full  interrupt  support 
built  in. 

Interrupts  are  effective  only  if  they  are  enabled  most  of  the  time 
since  interrupts  that  occur  while  interrupts  are  disabled  carmot  be 
detected.  Because  of  the  critical  timing  of  disk  read  and  write 
operations,  Pascal,  DOS  3.3,  and  ProDOS  turn  off  interrupts  while 
accessing  the  disk.  Thus  it  is  important  to  remember  that  while  a 
disk  drive  is  being  accessed,  all  the  interrupt  sources  discussed 
below  are  turned  off. 

On  the  Apple  He  only,  interrupts  are  periodically  turned  off  while 
80-column  screen  operations  are  being  performed.  This  is  most 
noticeable  while  the  screen  is  scrolling.  Also,  most  peripheral 
cards  used  in  the  Apple  He  disable  interrupts  while  reading  and 
writing. 
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Interrupt  handling  on  the  65C02 

From  the  point  of  view  of  the  65C02,  there  are  three  possible  causes 
of  interrupts. 

1 .  The  IRQ  line  on  the  microprocessor  can  be  pulled  low  if  65C02 
interrupts  are  not  masked  (that  is,  the  CLI  instruction  has  been 
used).  This  is  the  standard  technique  that  devices  use  when  they 
need  immediate  attention. 

2.  The  processor  executes  a  break  (BRK,  opcode  $00)  instruction. 

3.  A  nonmaskable  interrupt  (NMI)  occurs.  Because  the  NMI  line  in 
the  Apple  He's  65C02  is  not  used,  this  never  happens  on  the 
Apple  lie. 

The  first  two  possibilities  cause  the  65C02  to  save  the  current 
program  counter  and  status  byte  on  the  stack  and  then  jump  to  the 
routine  whose  address  is  stored  in  $FFFE  and  $FFFF.  The  sequence 
performed  by  the  65C02  is: 

1 .  If  an  IRQ  occurs,  finish  executing  the  current  instruction.  (If  a 
BRK  occurs,  the  current  instruction  is  already  finished.) 

2.  Push  the  high  byte  of  the  program  counter  onto  the  stack. 

3.  Push  the  low  byte  of  the  program  counter  onto  the  stack. 

4.  Push  the  program  status  byte  onto  the  stack. 

5.  Jump  to  the  address  stored  in  $FFFE,  $FFFF— that  is, 
JMP  ($FFFE). 

The  different  sources  of  interrupt  signals  are  discussed  below. 


The  interrupt  vector  at  $FFFE 

In  the  Apple  lie  there  are  three  separate  regions  of  memory  that 
contain  address  $FFFE:  the  built-in  ROM,  the  bank-switched 
memory  in  main  RAM,  and  the  bank-switched  memory  in  auxiliary 
RAM.  The  vector  at  $FFFE  in  the  ROM  points  to  Apple  He's  built-in 
interrupt  handling  routine.  You  should  generally  use  the  built-in 
interrupt  handler,  rather  than  writing  your  own,  because  of  the 
complexity  of  interrupts  on  the  Apple  lie. 
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when  you  initialize  the  mouse  or  serial  communication  firmware, 
copies  of  the  ROM's  interrupt  vector  are  placed  in  the  interrupt 
vector  addresses  in  both  main  and  auxiliary  bank-switched 
memory.  If  you  plan  to  use  interrupts  and  the  bank-switched 
memory  without  the  mouse  or  communication  firmware,  you  must 
copy  the  ROM's  interrupt  vector  yourself 


The  built-in  interrupt  tiandler 

The  built-in  interrupt  handler  is  responsible  for  determining 
whether  a  BRK  or  an  IRQ  interrupt  occurred.  If  it  was  an  IRQ 
interrupt,  it  decides  whether  the  interrupt  should  be  handled 
internally,  handled  by  the  user,  or  simply  ignored. 

The  built-in  interrupt-handling  routine  records  the  current  memory 
configuration,  then  sets  up  its  own  standard  memory  configuration 
so  that  a  user's  interrupt  handler  knows  the  precise  memory 
configuration  when  it  is  called. 

Next  the  handler  checks  to  see  if  the  interrupt  was  caused  by  a  break 
instruction,  and  if  it  was,  handles  it  as  described  later  in  this 
appendix. 

If  the  interrupt  was  not  caused  by  a  BRK,  the  handler  checks  for 
interrupts  that  it  knows  how  to  handle  (for  example,  a  properly 
initialized  mouse)  and  handles  them. 

Depending  on  the  state  of  the  system,  it  either  ignores  other 
interrupts  or  passes  them  to  a  user's  interrupt  handling  routine 
whose  address  is  stored  at  $03FE  and  $03FF  of  main  memory. 

After  handling  an  interrupt  itself,  or  after  the  user's  handler  returns 
(with  an  RTI),  the  built-in  interrupt  handler  restores  the  memory 
configuration,  and  then  does  an  RTI  to  restore  processing  to  where 
it  was  when  the  interrupt  occurred.  Table  E-1  illustrates  this  whole 
process.  Each  of  the  steps  is  explained  in  detail  in  the  sections  that 
follow. 


334  Appendix  E:  Interrupts 


Table  E-1 

Interrupt-handling  sequence 


Interrupted 

program  Processor  Built-in  handler  User's  tiandler 


Program — »-Push  address 
Push  status 


JMP  ($FFFE)— ^Save  old  and  set 
new  memory 
configuration 

If  BRK,  then  go 
to  break  handler 
($FA47) 


Our  interrupt? 

NO:  Push  address 
Push  status 

JMP  C$03FE)-^HandIe 
interrupt 


YES:  Handle  it 

Restore  memory-* — RTI 
configuration 


Pull  status  -< RTI 

Program-* — Pull  address 


Saving  the  memory  configuration 

The  built-in  interrupt  handler  saves  the  state  of  the  system,  and  sets 
it  to  a  known  state  according  to  these  rules: 

n  If  SOStore  and  Page2  are  on,  then  it  switches  in  text  Page  1  (Page2 
ofO  so  that  main  screen  holes  are  accessible. 

D  It  switches  in  main  memory  for  reading  (RAMRd  off). 

n  It  switches  in  main  memory  for  writing  (RAMWrt  off). 

n  It  switches  in  ROM  addresses  $DOOO-$FFFF  for  reading 
(RdLCRAM  off). 

D  It  switches  in  main  stack  and  zero  page  (AltZP  ofO- 

n  It  preserves  the  auxiliary  stack  pointer,  and  restores  the  main 
stack  pointer. 
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n  It  preserves  the  current  ROM  state  and  switches  in  the  ROM 
bank  1. 

♦  Note:  Because  main  memory  is  switched  in,  all  memory- 
addresses  used  later  in  this  appendix  are  in  main  memory 
unless  otherwise  specified. 


Managing  nnain  and  auxiliary  staclcs 

Because  the  Apple  lie  has  two  stack  pages,  the  firmware  has 
established  a  convention  that  allows  the  system  to  be  mn  with  two 
separate  stack  pointers.  Two  bytes  in  the  auxiliary  stack  page  are  to 
be  used  as  storage  for  inactive  stack  pointers:  $0100  for  the  main 
stack  pointer  when  the  auxiliary  stack  is  active,  and  $0101  for  the 
auxiliary  stack  pointer  when  the  main  stack  is  active. 

When  a  program  that  uses  interrupts  switches  in  the  auxiliary  stack 
for  the  first  time,  it  should  place  the  value  of  the  main  stack  pointer 
at  auxiliary  stack  address  $0100,  and  initialize  the  auxiliary  stack 
pointer  to  $FF  (the  top  of  the  stack).  When  it  subsequently  switches 
from  one  stack  to  the  other,  it  should  save  the  current  stack  pointer 
before  loading  the  pointer  for  the  other  stack. 

When  an  interrupt  occurs  while  the  auxiliary  stack  is  switched  in,  the 
current  stack  pointer  is  stored  at  $0101,  and  the  main  stack  pointer 
is  retrieved  from  $0100.  Then  the  main  stack  is  switched  in  for  use. 
After  the  interrupt  has  been  handled,  the  stack  pointer  is  restored  to 
its  original  value. 


User's  interrupt  handler  at  $03FE 

You  can  set  up  screen  hole  locations  to  indicate  that  the  user's 
interrupt  handler  should  be  called  when  certain  interrupts  occur. 
To  do  this,  place  your  interrupt  handler's  address  at  $03FE  and 
$03FF  in  main  memory,  low  byte  first. 

The  user's  interrupt  handler  should  do  the  following: 

n  Verify  that  the  interrupt  came  from  the  expected  source.  The 
following  sections  describe  how  this  should  be  done  for  each 
interrupt  source. 

n  Handle  the  interrupt  as  desired. 

a  Clear  the  interrupt,  if  necessary.  The  following  sections  describe 
how  to  clear  the  interrupts. 

n  Return  with  an  RTI. 
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If  your  interrupt  handler  needs  to  know  the  memory  configuration  at 
the  time  of  the  interrupt,  it  can  check  the  encoded  byte  stored  four 
bytes  down  on  the  stack.  This  byte  is  explained  later  in  this 
appendix. 

In  general  there  is  no  guaranteed  maximum  response  time  for 
interrupts.  This  is  because  the  system  may  be  doing  a  disk 
operation,  which  could  last  for  several  seconds. 

Once  the  built-in  interrupt  handler  has  been  called,  it  takes 
about  250  to  300  microseconds  for  it  to  call  your  interrupt-handling 
routine.  After  your  routine  returns,  it  takes  40  to  140  microseconds 
to  restore  memory  and  return  to  the  interrupted  program. 

If  memory  is  in  the  standard  state  when  the  interrupt  occurs,  the 
total  overhead  for  interrupt  processing  is  about  150  microseconds 
less  than  if  memory  is  in  the  worst  possible  state  (SOStore  and  Page2 
on,  auxiliary  memory  switched  in  for  reading  and  writing,  auxiliary 
bank-switched  memory  page  $02  switched  in  for  reading  and 
writing). 


Handling  break  instructions 

After  the  interrupt  handler  has  set  the  memory  configuration,  it 
checks  to  see  if  the  interrupt  was  caused  by  a  BRK  (opcode  $00) 
instruction.  (If  it  was,  bit  4  of  the  processor  status  byte  is  a  1.)  If  so, 
it  jumps  to  a  break-handling  routine,  which  saves  the  state  of  the 
computer  at  the  time  of  the  break  as  follows: 

Information  Location 

Program  counter  Oow  byte)  $3A 

Program  counter  Oiigh  byte)  $3B 

Encoded  memory  state  $44 

Accumulator  $45 

X  register  $46 

Y  register  $47 

Status  register  $48 

Finally,  the  break  routine  jumps  to  the  routine  whose  address  is 
stored  at  $03F0  and  $03F1. 
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The  encoded  memory  state  in  location  $44  can  be  interpreted  as 
follows: 

Bit  7  =  0 

Bit  6  =  1  if  SOStore  and  Page2  both  on 

Bit  5  =  1  if  auxiliary  RAM  switched  in  for  reading 

Bit  4  =  1  if  auxiliary  RAM  switched  in  for  writing 

Bit  3  =  1  if  bank-switched  RAM  being  read 

Bit  2  =  1  if  bank-switched  $DOO0  page  $01  switched  in 

Bit  1  =  1  if  bank-switched  $D(X)0  page  $02  switched  in 

Bit  0  =  0 


Sources  of  interrupts 

The  Apple  lie  can  receive  interrupts  from  many  different  sources. 
Each  source  is  enabled  and  used  slightly  differently  from  the  others. 
There  are  two  basic  sources  of  interrupts:  use  of  the  mouse,  and 
actions  affecting  the  two  6551  ACIA  circuits  (the  chips  that  control 
serial  communication).  How  to  use  these  sources  of  interrupts  in 
conjunction  with  the  built-in  interrupt  handler  is  discussed  later  in 
this  appendix. 

Mouse  use  can  cause  intermpts  when 
n  the  mouse  is  moved  in  the  horizontal  (X)  direction 
n  the  mouse  is  moved  in  the  vertical  (Y)  direction 
n  the  mouse  button  is  pressed 

Interrupts  can  also  be  generated  every  l/60  second  by  the  rising 
edge  of  the  vertical  blanking  signal.  This  is  called  the  vertical 
blanking  (VBL)  interrupt  and  is  synchronized  with  a  signal  used  for 
the  video  display. 

Actions  affecting  the  ACIA  circuits  can  cause  interrupts  when 

D  a  key  is  pressed  (the  firmware  can  use  this  intermpt  to  buffer 
keystrokes,  or  it  can  pass  the  interrupt  on  to  the  user) 

n  either  ACIA  has  received  a  byte  of  data  from  its  port  (the 
firmware  can  use  this  interrupt  to  buffer  data  or  it  can  pass  the 
interrupt  on  to  the  user) 

D  pin  5  of  either  serial  port  changes  state  (device  ready/not  ready 
to  accept  data)  (when  the  serial  firmware  is  active,  this  interrupt 
is  absorbed;  however,  the  serial  firmware  uses  the  signal  to 
decide  whether  or  not  to  transmit  the  next  byte  of  data) 
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n  either  ACIA  is  ready  to  accept  another  character  to  be 

transmitted  (when  the  serial  firmware  is  active,  this  interrupt  is 
absorbed;  however,  the  serial  firmware  uses  the  signal  to  decide 
whether  or  not  to  transmit  the  next  byte  of  data) 

D  the  keyboard  strobe  is  cleared  (the  firmware  absorbs  this 
interrupt) 

An  interrupt  can  also  be  generated  by  a  device  attached  to  the 
external  disk  drive  port.  The  firmware  can  pass  this  interrupt  on  to 
the  user. 


Firmware  handling  of  interrupts 

The  following  sections  discuss  how  the  various  sources  of  interrupts 
should  be  used  together  with  the  built-in  interrupt  handler. 


Firmware  for  mouse  and  VBL 

As  described  in  Chapter  9,  the  mouse  can  be  initialized  (by  the 
SetMouse  call)  to  nine  different  modes  that  enable  one  or  more 
sources  of  interrupts.  In  transparent  mode,  the  interrupts  are 
entirely  handled  by  the  built-in  interrupt  handler;  the  other  modes 
require  a  user-installed  interrupt  handler. 

When  the  mouse  is  initialized,  the  interrupt  vector  is  copied  to 
addresses  $FFFE  and  $FFFF  in  main  and  auxiliary  bank-switched 
RAM.  This  permits  mouse  interrupts  with  any  memory 
configuration. 

When  the  mouse  is  active,  possible  sources  of  interrupts  are  those 
listed  earlier  in  this  appendix  as  resulting  from  mouse  use. 

When  an  interrupt  occurs,  the  built-in  interrupt  handler  determines 
whether  that  particular  interrupt  source  was  enabled  (by  the 
SetMouse  call).  If  so,  the  user's  interrupt  handler,  whose  address  is 
stored  at  $03FE,  is  called. 

The  user's  interrupt  handler  should  first  call  ServeMouse  to 
determine  the  source  of  the  interrupt.  This  call  updates  the  mouse 
status  byte  at  $077C  and  returns  with  the  carry  bit  clear  if  mouse 
movement,  button,  or  vertical  blanking  was  the  source  of  the 
interrupt. 
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The  values  of  this  mouse  status  byte  at  $077C  ($077F  in  the  memory 
expansion  lie)  are  as  follows: 

Bit       1  means  that 

3        Intermpt  was  from  vertical  blanking 

2        Interrupt  was  from  button 

1        Interrupt  was  from  mouse  movement 

If  the  interrupt  was  due  to  mouse  movement  or  button,  the  user's 
interrupt  handler  should  then  do  a  call  to  ReadMouse.  This  causes 
the  mouse  coordinates  and  status  to  be  updated  as  follows: 

$047C  Low  byte  of  X  coordinate 

$04FC  Low  byte  of  Y  coordinate 

$057C  High  byte  of  X  coordinate 

$05FC  High  byte  of  Y  coordinate 

$077C  Button  and  movement  status 

Bit         Means 

7  0  =  button  up;  1   =  button  down 

6  0  =  button  up  on  last  ReadMouse 

1   =  button  down  on  last  ReadMouse 
5  0  =  no  movement  since  last  ReadMouse 

1    =   movement  since  last  ReadMouse 
3-1      Always  set  to  0  (interrupt  cleared) 

After  the  interrupt  has  been  handled,  the  routine  should  terminate 
with  an  RTI. 

Remember  that  interrupts  may  be  missed  during  disk  accesses. 

If  you  turn  on  mouse  interrupts  without  initializing  the  mouse,  the 
built-in  interrupt  handler  will  absorb  the  interrupts.  If  you  want  to 
handle  mouse  interrupts  yourself,  you  must  write  your  own  interrupt 
handler  and  place  vectors  to  it  at  addresses  $FFFE  and  $FFFF  in 
bank-switched  RAM.  Interrupts  will  be  ignored  whenever  the 
$DOOO-$FFFF  ROM  is  switched  in. 


Firmware  for  keyboard  interrupts 

The  Apple  lie  hardware  is  able  to  generate  an  interrupt  when  a  key  is 
pressed.  The  firmware  is  able  to  buffer  up  to  128  keystrokes, 
completely  transparently,  when  properly  enabled  to  do  so.  It  saves 
them  in  the  second  half  of  page  $08  of  auxiliary  memory.  After  the 
buffer  is  full,  subsequent  keystrokes  are  ignored.  Because  interrupts 
are  only  generated  when  keypresses  occur,  characters  generated  by 
the  auto-repeat  feature  are  not  buffered.  They  can,  however,  be 
read  when  the  buffer  is  empty. 
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Once  keyboard  buffering  has  been  turned  on,  the  next  key  should  be 
read  by  caUing  RdKey  ($FDOC). 


Warning      Do  not  call  the  buffer  reading  routine  directly,  Its  entry  address 
will  not  be  thie  same  In  future  versions  of  the  computer. 

The  special  characters  Control-S  (stop  list)  and  Control-C  (stop 
Applesoft  execution)  do  not  work  while  keyboard  buffering  is  turned 
on.  A  new  keystroke,  Solid  Apple-Control-X,  dears  the  buffer. 


Using  keyboard  buffering  firmware 

Keyboard  buffering  is  automatically  turned  on  when  the  serial 
firmware  is  placed  in  terminal  mode.  Otherwise  you  must  turn  it  on 
yourself  this  way: 


Memory  expansion     The  Apple  lie  that  supports  memory  expansion  places  the 

keyboard  screen  holes  In  different  locations  from  those  used  In 
earlier  versions.  For  the  memory  expansion  lie,  change  all  $nnnF 
addresses  to  SnnnC  (that  Is,  change  $05FF  to  $05FC). 

1.  Disable  processor  interrupts  (SEI). 

2.  Set  location  $05FA  to  $80.  This  tells  the  firmware  to  buffer 
keystrokes  without  calling  the  user's  interrupt  handler. 

3.  Set  locations  $05FF  and  $06FF  to  $80.  These  are  pointers  to 
where  in  the  buffer  the  next  keystroke  will  be  stored  and  where  the 
next  will  be  read  from,  respectively. 

4.  Turn  on  the  ACIA  for  port  2  by  setting  the  low  nibble  of  $COAA  to 
the  value  $0F.  For  example: 

LDA  $COAA       Read  port  2  ACIA  command  register 

ORA  #$0F  Set  low  nibble  to  $0F 

STA  $C0AA       Set  port  2  ACIA  command  register 

If  you  are  using  the  serial  ports  at  the  same  time,  just  set  the  low 
bit  of  $COAA  to  1.  This  prevents  receiver  interrupts  from  being 
turned  off. 

A  PR#2  or  IN#2  or  the  equivalent  will  shut  off  keyboard 
interrupts. 

5.  Enable  processor  interrupts  (CLI). 
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Using  keyboard  interrupts  ttirougfi  firnnware 

Keyboard  intermpts  are  received  through  the  ACIA  for  port  2.  They 
can  be  enabled  as  follows: 

1.  Disable  processor  interrupts  (SET). 

2.  Set  location  $05FA  to  $C0.  This  tells  the  firmware  to  identify  a 
keystroke  interrupt,  and  to  call  the  user's  interrupt  handler. 

3.  Turn  on  the  ACIA  for  port  2  by  setting  the  low  nibble  of  $COAA  to 
the  value  $0F.  For  example: 

LDA  $COAA       Read  port  2  ACIA  command  register 

ORA  #$0F         Set  low  nibble  to  $0F 

STA  $COAA       Set  port  2  ACIA  command  register 

4.  Enable  processor  interrupts  (CLI). 

When  the  user's  interrupt  handler  is  called,  it  can  identify  the 
keyboard  as  the  interrupt  source  by  reading  location  $04FA.  This  is 
a  copy  of  the  ACIA  status  register  at  the  time  of  the  interrupt.  If  the 
interrupt  was  due  to  something  on  the  ACIA  for  port  2,  bit  7  is  set.  If 
the  interrupt  was  caused  by  a  keystroke,  bit  6  is  set  and  bit  5  is 
unchanged. 

After  servicing  this  interrupt,  the  interrupt  handler  should  clear  the 
interrupt  by  setting  $04FA  to  $00. 


Using  external  interrupts  tiirough  firmware 

Pin  9  of  the  external  disk  drive  connector  (EXTINT)  can  be  used  to 
generate  interrupts  through  the  ACIA  for  port  1.  It  can  be  used  as  a 
source  of  interrupts  (on  a  high-to-low  transition)  if  enabled  as 
follows: 

1.  Disable  processor  interrupts  (SEI). 

2.  Set  location  $05F9  to  $C0.  This  tells  the  firmware  to  identify  an 
external  interrupt,  and  to  call  the  user's  interrupt  handler. 

3.  Turn  on  the  ACIA  for  port  1  by  setting  the  low  nibble  of  $C09A  to 
the  value  $0F.  For  example: 

LDA  $C0  9A       Read  port  1  ACIA  command  register 

ORA  #$0F         Set  low  nibble  to  $0F 

STA  $C09A       Set  port  1  ACIA  command  register 

4.  Enable  processor  interrupts  (CLI). 
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when  the  user's  interrupt  handler  is  called,  it  can  identify  this 
interrupt  by  reading  location  $04F9.  This  is  a  copy  of  the  ACIA 
status  register  at  the  time  of  the  interrupt.  If  the  interrupt  was  due  to 
something  on  the  ACIA  for  port  1,  bit  7  is  set.  If  the  interrupt  was 
caused  by  the  external  interrupt  line,  bit  6  is  clear  and  bit  5  is 
unchanged. 

After  servicing  this  interrupt,  the  interrupt  handler  should  dear  the 
interrupt  by  setting  $04F9  to  $00. 


Firmware  for  serial  interrupts 

The  Apple  lie  hardware  is  able  to  generate  interrupts  both  when  the 
ACIA  receives  data  and  when  it  is  ready  to  send  data.  The  built-in 
interrupt  handler  responds  to  incoming  data  only.  The  firmware  is 
able  to  buffer  up  to  128  incoming  bytes  of  serial  data  from  either 
serial  port.  After  the  buffer  is  full,  data  are  ignored.  Only  one  port 
can  be  buffered  at  a  time.  The  following  sections  assume  that  the 
serial  port  to  be  buffered  is  already  initialized,  as  explained  in 
Chapter  8. 

Using  serial  buffering  transparently 

Serial  buffering  is  automatically  turned  on  when  the  serial  firmware 
is  placed  in  terminal  mode.  Otherwise  you  must  turn  it  on  yourself, 
as  follows: 

Memory  expansion      For  the  memory  expansion  lie,  change  all  SnnnF  addresses  to 
SnnnC  and  change  the  SOD  value  to  $09. 

1.  Disable  processor  interrupts  (SEI). 

2.  Set  location  $04FF  to  $C1  to  buffer  port  1,  or  to  $C2  to  buffer 
port  2. 

3.  Set  locations  $057F  and  $067F  to  $00.  These  are  pointers  to  the 
next  byte  in  the  buffer  to  be  used  and  the  next  character  to  be 
read  from  the  buffer,  respectively. 

4.  Turn  on  the  ACIA  for  the  port  by  setting  the  low  nibble  of  $C09A 
for  port  1  or  $COAA  for  port  2  to  $0D.  For  example: 

LDA  $C0  9A  Read  port  1  ACIA  command  register 

AND  $F0  Clear  low  nibble 

ORA  #$0D  Set  low  nibble  to  $0D 

STA  $C0  9A  Set  port  1  ACIA  command  register 

The  0  in  bit  1  of  the  command  register  enables  receiver 
interrupts;  thus  an  interrupt  is  generated  when  a  byte  of  data  is 
received. 
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5.  Enable  processor  interrupts  (CLI). 

When  serial  port  buffering  is  thus  enabled,  normal  reads  from  the 
serial  port  firmware  fetch  data  from  the  buffer  rather  than  directly 
from  the  ACIA. 

Using  serial  interrupts  through  firmware 

It  is  also  possible  to  use  the  firmware  to  call  the  user  interrupt 
handler  whenever  a  byte  of  data  is  read  by  the  ACIA.  In  this  mode 
buffering  is  not  performed  by  the  firmware. 

Memory  expansion      For  the  memory  expansion  lie,  change  all  SnnnF  addresses  to 
$nnnC  and  change  the  $0D  value  to  $09. 

1.  Disable  processor  interrupts  (SEI). 

2.  Set  location  $04FF  to  a  value  other  than  $C1  or  $C2. 

3.  Turn  on  the  ACIA  for  the  port  by  setting  the  low  nibble  of  $C09A 
for  port  1  or  $COAA  for  port  2  to  $0D.  For  example: 

LDA  $C0  9A  Read  port  1  ACIA  command  register 

AND  $F0  Clear  low  nibble 

ORA  #$0D  Set  low  nibble  to  $0D 

STA  $C0  9A  Set  port  1  ACIA  command  register 

The  0  in  bit  1  of  the  command  register  enables  receiver 
interrupts;  thus  an  interrupt  is  generated  when  a  byte  of  data  is 
received. 

4.  Enable  processor  interrupts  (CLI). 

When  a  serial  port  is  thus  enabled,  the  user's  interrupt  handler  is 
called  each  time  the  port  receives  a  byte  of  data.  The  status  byte 
saved  by  the  firmware  ($04F9  for  port  1;  $04FA  for  port  2)  has  the 
high  bit  set  if  the  interrupt  occurred  on  that  port.  Bit  3  is  set  if  the 
interrupt  was  due  to  a  received  byte  of  data. 

The  interrupt  handler  should  clear  the  interrupt  by  clearing  bits  7 
and  3  of  that  port's  status  byte  ($04F9  for  port  1;  $04FA  for  port  2). 

Transmitting  serial  data 

The  serial  firmware  does  not  implement  buffering  for  serial  output. 
Instead  it  waits  for  two  conditions  to  be  true  before  transmitting  a 
character: 

n  The  ACIA's  transmit  register  must  be  ready  to  accept  a  character. 
This  is  true  if  bit  4  of  the  ACIA's  status  register  is  1. 

n  The  device  must  signal  that  it  is  ready  to  accept  data.  This  is  true 
if  bit  5  of  the  ACIA's  status  register  is  0.  Bit  5  is  0  if  pin  5  of  the 
port's  connector  is  also  0. 
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When  the  serial  firmware  is  active,  a  change  of  state  on  pin  5  of  that 
port  generates  an  interrupt.  That  interrupt  is  absorbed,  but  the  data 
remain  in  bit  5  of  the  status  register.  Interrupts  from  the  ACIA's 
transmit  register  are  normally  disabled. 

A  loophole  in  the  firmware 

So  that  programs  can  make  use  of  interrupts  on  the  ACIAs  without 
affecting  mouse  interrupt  handling,  there  is  a  tiny  loophole 
purposely  left  in  the  built-in  interrupt  handler.  If  transmit  interrupts 
are  enabled  on  the  ACLA. — ^that  is,  if  bits  3,  2,  and  0  of  the  ACIA's 
command  register  have  the  values  0,  1,  and  1,  respectively — then 
control  is  passed  to  the  user's  interrupt  handler  if  the  interrupt  is  not 
intended  for  the  mouse  (movement,  button,  or  VBL). 

This  means  that  you  can  write  more  sophisticated  serial  interrupt- 
handling  routines  than  the  limited  firmware  space  could  provide 
(such  as  printer  spooling).  The  firmware  will  still  set  memory  to  its 
standard  state,  handle  mouse  interrupts,  and  restore  memory  after 
your  routine  is  finished. 

When  you  receive  the  interrupt,  neither  ACIA's  status  register  has 
been  read.  You  are  fully  responsible  for  checking  for  interrupts  on 
both  ACIAs,  determining  which  of  the  four  interrupt  sources  on 
each  ACIA  caused  the  interrupt,  and  how  to  handle  them.  Refer  to 
the  6551  specification  for  more  details.  The  built-in  firmware  itself 
is  an  excellent  example  of  how  interrupts  on  the  ACIA  can  be 
handled. 


Bypassing  the  interrupt  firmware 

The  following  sections  give  further  details  on  using  interrupts  on  the 
Apple  lie  computer  without  using  the  built-in  interrupt  handler. 

A  method  of  handling  mouse  interrupts  directly  is  described  in 
Chapter  9. 


Using  mouse  Interrupts  without  the  firmware 

To  use  mouse  interrupts  without  the  firmware,  as  mentioned  above, 
you  must  set  your  own  interrupt  vectors.  If  the  $DOOO-$FFFF  ROM  is 
ever  switched  in,  the  built-in  interrupt  handler  will  absorb  the 
mouse  interrupts. 
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Tables  E-2  and  E-3  show  how  to  activate  and  read  mouse  intermpts 
without  using  the  firmware.  Remember  to  disable  interrupts  (SEI) 
before  enabling  mouse  interrupts,  then  turn  them  on  when  done 
CCLI). 


Table  E-2 

Activating  mouse  Interrupts 


To  activate 
interrupts  on 

Enable 
lOU  access 

Select 
source 

Enable 
source 

Disable 
lOU  access 

Mouse  X 
(rising  edge) 

STA  $C079 

STA  $C05C 

STA  $C059 

STA  $C078 

Mouse  X 
(falling  edge) 

STA  $C079 

STA  $C05D 

STA  $C059 

STA  $C078 

Mouse  Y 
(rising  edge) 

STA  $C079 

STA  $C05E 

STA  $C059 

STA  $C078 

Mouse  Y 
(falling  edge) 

STA  $C079 

STA  $C05F 

STA  $C059 

STA  $C078 

VBL 

STA  $C079 

STA  $C05B 

STA  $C078 

Table  E-3 

Reading  mouse  Interrupts 

To  read 
Interrupts  from 

Read  direction        Determine               Handle 
(A.S.A.P)                 source                      It               Return 

Mouse  X 


Mouse  Y 


LDA  $C066 


LDA  $C067 


VBL 


LDA  $C015 
(bit  7=1  if  true) 

LDA  $C017 
(bit  7=1  if  true) 

LDA  $C019 
(bit  7=1  if  true) 


RTI 


RTI 


RTI 


The  mouse  direction  data  read  from  $C066  and  $C067  are 
guaranteed  valid  for  at  least  40  microseconds,  and  average  duration 
is  at  least  200  microseconds,  so  you  should  read  the  direction  as 
soon  as  possible. 
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Using  ACI A  interrupts  without  the  firmware 

To  use  ACIA  interrupts  without  the  firmware,  you  must  set  your  own 
interrupt  vectors.  If  the  $DOOO-$FFFF  ROM  is  ever  switched  in,  the 
built-in  interrupt  handler  will  handle  the  interrupt  as  determined  by 
certain  mode  bytes. 

When  writing  your  serial  interrupt  handler,  refer  to  Figures  11-31 
through  11-33  and  to  the  Synertek  6551  ACIA  specification.  As 
shown  in  Chapter  11,  the  ACIAs  have  the  following  connections: 

Port  1        DSR  line  connected  to  the  EXTINT  line  on  the 
external  disk  port. 
DCD  line  connected  to  pin  5  of  port  1  connector. 

Port  2       DSR  line  goes  high  when  a  key  is  pressed. 

DCD  line  connected  to  pin  5  of  port  2  connector. 

The  ACIA  registers  have  the  following  addresses: 

Port  1  Port  2 

Data  register  =  $C098  Data  register  =  $C0A8 

Status  register  =  $C099  Status  register  =  $C0A9 

Command  register  =  $C09A  Command  register  =  $COAA 

Control  register       =  $C09B  Control  register       =  $COAB 
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Apple  II   Series   Differences 


This  appendix  compares  the  Apple  lie  to  the  Apple  He, 
Apple  II  Plus,  and  Apple  11.  It  does  not  contain  an  exhaustive  list  of 
differences,  but  it  does  mention  those  differences  most  likely  to 
affect  the  accuracy  of  programs,  displays,  and  instructions  created 
for  end  users  of  two  or  more  Apple  II  series  models. 


Overview 

The  differences  between  the  Apple  II  series  computers  can  be 
expressed  as  a  series  of  equations-,  this  computer  equals  that  one 
plus  or  minus  certain  features. 

The  following  equations  compare  each  model  of  Apple  II  series  with 
its  predecessor  in  terms  of  functional  equivalence,  not  literal 
equality.  For  example, 

Apple  II  Plus  =  Apple  II  -  Integer  BASIC  firmware 

does  not  mean  that  Integer  BASIC  firmware  can  be  removed  from 
the  Apple  II — ^just  that  the  one  machine  functions  as  if  it  were  the 
other  without  such  firmware. 

Apple  II  Plus  =  11  +  Autostart  ROM 

+  Applesoft  firmware 
+  48K  RAM  standard 

-  old  Monitor  ROM 

-  Integer  BASIC  firmware 
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Apple  Me       =  II  Plus  +  Apple  Language  Card  (with  16K  of  RAM) 
+  80-column  (enhanced)  video  firmware 
+  built-in  diagnostics 
+  full  ASCII  keyboard 
+  internal  power  light 
+  FCC  approval 
+  improved  back  panel 
+  9-pin  back  panel  game  connector 
+  auxiliary  slot  (with  possibility  of  80-column 
text  card  and  extra  64K  RAM) 

-  slot  0 

+  interrupt  support  in  firmware 

(enhanced  Apple  He) 
+  Mini-Assembler  in  firmware 

(enhanced  Apple  He) 

Apple  lie       =  He        +  extended  80-column  text  card 
+  80/40  switch 
+  keyboard  switch 
+  disk-use  light 
+  disk  controller  port 
+  disk  drive 
+  mouse  port 
+  serial  printer  port 
+  serial  communication  port 
+  built-in  port  firmware 
+  video  expansion  connector 

-  removable  cover 

-  slots  1  to  7 

-  auxiliary  slot 

-  internal  power  light 

-  cassette  I/O  connectors 

-  internal  game  I/O  connector 
(hence  no  game  output) 

-  auxiliary  video  pin 

-  Monitor  cassette  support 

+  Mini-Assembler  in  firmware  (Apple  lie  with 

UniDisk  3.5  support) 
+  Smartport  in  firmware  (UniDisk  3.5  and 

memory  expansion  Apple  lie) 
+  memory  expansion  card  support 

(memory  expansion  Apple  lie) 
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Type  of  processor 

The  processor  in  the  Apple  II  and  II  Plus  is  the  6502.  The  original 
Apple  He  uses  a  6502A.  The  Apple  lie  and  enhanced  Apple  He  both 
use  the  65C02:  this  is  a  redesigned  CMOS  CPU  that  has  27  new 
instructions,  new  addressing  modes,  and  for  some  instructions  a 
differing  execution  scheme  and  machine  cycle  counts  (see 
Appendix  A). 

Programs  written  for  the  Apple  lie  will  run  on  the  earlier  machines 
only  if  they  do  not  contain  instructions  unique  to  the  65C02,  or 
depend  on  shared  instructions  whose  cycle  times  differ.  Programs 
should  also  use  only  published  entry  points  in  the  Monitor  firmware 
to  allow  maximum  compatibility  between  different  Apple  II  series 
computers. 


Machine  identification 

Identification  of  Apple  II  series  computers  is  as  shown  in  Table  F-1. 

Table  F-1 

Apple  II  series  Identification  bytes 

Machine  $FBB3       $FB1E        $FBCO       $FBBF 

Apple  II 

Apple  II  Plus 

Apple  He 

Apple  He  (enhanced) 

Apple  lie 

Apple  He  (UniDisk  3.5  support) 

Apple  lie  (memory  expansion) 

Apple  III  in  Apple  II 

emulation  mode  $EA        $8A 

Any  future  Apple  II  series  computer  or  ROM  release  will  have 
different  values  in  these  locations.  Machine  identification  routines 
are  available  from  Apple  Vendor  Technical  Support. 

The  MachID  byte  for  ProDOS  ($BF98  on  the  global  page)  will  have 
bit  3  set  to  0  if  the  computer  is  an  Apple  II,  II  Plus,  He,  or  III,  and 
to  1  if  the  computer  is  not  one  of  these  machines.  In  an  Apple  He, 
bits  7  and  6  are  also  set  to  binary  10. 

Bits  7  and  6  set  to  binary  10  indicate  that  a  computer  is  Apple  lie 
and  lie  compatible,  regardless  of  the  value  of  bit  3. 


$EA 

$AD 

$06 

$EA 

$06 

$E0 

$06 

$00 

$FF 

$06 

$00 

$00 

$06 

$00 

$03 
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Memory  structure 

This  section  compares  the  memory  organization  of  the  Apple  lie 
with  that  of  the  Apple  II,  II  Plus,  and  He.  These  machines  differ  in 
RAM  space,  ROM  space,  slot  or  port  address  space,  and  hardware 
page  use. 


Amount  and  address  ranges  of  RAM 

The  Apple  II  could  have  as  little  as  4K  of  RAM  at  the  time  of 
purchase,  and  could  be  upgraded  to  as  much  as  48K  of  RAM. 

The  Apple  II  Plus  has  48K  of  RAM  ($0000  through  $BFFF)  as  a 
standard  feature.  With  the  addition  of  an  Apple  Language  Card,  a 
48K  Apple  II  or  II  Plus  could  be  expanded  to  have  64K  of  RAM. 

The  Apple  He  has  a  full  64K  of  RAM.  The  top  12K  addresses  overlap 
with  the  ROM  addresses  $D000  through  $FFFF.  There  is  an 
additional  bank-switched  area  of  4K  from  $D000  through  $DFFF. 
This  arrangement  is  equivalent  to  an  Apple  II  Plus  with  an  Apple 
Language  Card  installed.  A  program  selects  between  the  RAM  and 
ROM  address  spaces  and  between  the  $Dxxx  banks  by  changing  soft 
switches  located  in  memory. 

With  an  Extended  80-Column  Text  Card  installed  in  its  auxiliary 
slot,  an  Apple  He  has  an  additional  64K  of  RAM  available,  although 
no  more  than  half  of  the  128K  of  RAM  space  is  available  at  any  given 
time.  Soft  switches  located  in  memory  control  these  address  space 
selections. 

The  RAM  in  the  Apple  lie  is  equivalent  to  the  RAM  in  an  Apple  He 
with  an  Extended  80-Column  Text  Card.  The  optional  memory 
expansion  card  can  add  as  much  as  1Mb  of  RAM  to  the  lie  in  256K 
steps. 


Amount  and  address  ranges  of  ROM 

The  Apple  II  has  8K  of  ROM  ($E000  through  $FFFF),  and  the 
Apple  II  Plus  has  12K  of  ROM  ($D000  through  $FFFF).  Users  can 
plug  their  own  ROMs  into  the  sockets  provided.  The  on-board  (as 
opposed  to  slot)  ROM  address  range  is  from  $D000  through  $FFFF. 
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The  Apple  He  has  16K  of  ROM,  of  which  it  uses  15.75K  (addresses 
$C100  through  $FFFF;  page  $C0  addresses  are  for  I/O  hardware). 
ROM  addresses  $C300  through  $C3FF  (normally  assigned  to  the 
ROM  in  a  card  in  slot  3)  and  $C800  through  $CFFF  contain  80- 
column  video  firmware;  ROM  addresses  $C100  through  $C2FF  and 
$C400  through  $C7FF  (normally  assigned  to  the  ROM  on  cards  in 
slots  1,  2,  4,  5,  6,  and  7)  contain  built-in  self-test  routines. 

A  soft  switch  in  RAM  controls  whether  the  video  firmware  or  slot  3 
card  ROM  is  active.  Invoking  the  self-tests  with  Solid  Apple- 
Control-Reset  causes  the  self-test  firmware  to  take  over  the  slot  ROM 
address  spaces. 

The  Apple  lie  ROM  also  uses  the  15.75K  from  $C100  through  $FFFF, 
and  its  enhanced  video  firmware  has  the  same  entry  point  addresses 
as  on  the  Apple  He.  However,  there  are  only  rudimentary  built-in 
self-tests,  and  these  do  not  preempt  any  port  firmware  space. 


UniDisk  3.5     The  Apple  He  with  buiit-in  UniDisk  3.5  support  has  twice  the 
ROM  (32K)  of  the  original  Apple  He.  The  extra  ROM  contains 
support  for  the  Smartport,  a  Mini-Assembler,  STEP  and  TRACE 
functions  in  the  Monitor  firmware,  expanded  self-test  routines, 
and  improved  interrupt  support. 

In  the  Apple  lie,  addresses  $C100  through  $CFFF  contain  I/O  and 
interrupt  firmware,  addresses  $D000  through  $F7FF  contain  the 
Applesoft  BASIC  interpreter,  and  addresses  $F800  through  $FFFF 
contain  the  Monitor. 


Peripheral-card  memory  spaces 

Each  Apple  lie  port  has  up  to  16  peripheral-card  I/O  space 
locations  in  main  memory  on  the  hardware  page  (beginning  at 
location  $COsO  +  $80  for  slot  or  port  s),  allocated  in  the  standard 
Apple  II  series  way  (that  is,  beginning  at  location  $COsO  +  $80  for 
each  slot  s). 

The  peripheral-card  ROM  space  (page  $Cs  for  slot  s  in  the  Apple  II, 
II  Plus,  and  He)  contains  the  starting  and  entry-point  addresses  for 
port  s,  but  port  routines  are  not  limited  to  their  allocated 
$Cs  pages. 

The  2K-byte  expansion  ROM  space  from  $C800  to  $CFFF  in  the 
Apple  lie  is  used  by  the  enhanced  video  firmware  and 
miscellaneous  I/O  and  memory-transfer  routines. 
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The  128  bytes  of  peripheral-card  RAM  space  Cor  scratch-pad  RAM) 
(64  screen  holes  in  main  memory  and  their  equivalent  addresses  in 
auxiliary  memory)  are  reserved  for  use  by  the  built-in  firmware.  It  is 
extremely  important  for  the  correct  operation  of  Apple  lie  firmware 
that  these  locations  not  be  altered  by  software  except  for  the  specific 
purposes  described  in  Chapters  7,  8,  and  9,  and  in  Appendix  E. 


Hardware  addresses 

The  hardware  page  (the  addresses  from  $C(X)0  through  $COFF) 
controls  memory  selection  and  input/output  hardware 
characteristics.  All  input  and  output  (except  video  output)  takes 
place  at  one  or  more  hardware  page  addresses.  For  the  sake  of 
simplicity,  this  section  presents  only  a  general  comparison  between 
the  Apple  lie  on  the  one  hand,  and  the  Apple  II,  II  Plus,  and  He  on 
the  other,  with  respect  to  hardware  page  use.  However,  for  many 
characteristics,  the  Apple  He  and  lie  work  one  way,  while  the 
Apple  II  and  II  Plus  work  another. 

$COOO-$COOF 

On  all  Apple  II  series  computers,  reading  any  one  of  these 
addresses  reads  the  keyboard  data  and  strobe.  On  the  Apple  He 
and  lie,  writing  to  each  of  these  addresses  turns  memory  and 
display  switches  on  and  off.  Writing  to  addresses  $C006,  $C007, 
$COOA,  and  $CO0B  performs  ROM  selection  on  the  Apple  He. 
Writing  to  these  four  addresses  is  reserved  on  the  Apple  lie. 

For  reading  the  keyboard,  use  $C000;  reserve  $C001  through 
$COOF. 

$C010-$C01F 

On  all  Apple  II  series  computers,  writing  to  any  one  of  these 
addresses  clears  the  keyboard  strobe.  On  the  Apple  He  and  lie, 
reading  each  of  these  addresses  checks  the  status  of  a  memory  or 
display  switch,  or  the  any-key-down  flag. 

For  clearing  the  keyboard  strobe,  use  $C010;  reserve  $C011  through 
$C01F. 
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Reading  $C015  checks  the  SLOTCXROM  switch  on  the  Apple  He, 
but  it  resets  the  X-movement  interrupt  (Xlnt)  on  the  Apple  lie. 
Similarly,  reading  $C017  checks  the  SLOTC3ROM  switch  on  the 
Apple  He,  but  it  resets  the  Y-movement  interrupt  (YInt)  on  the 
Apple  lie. 

Reading  $C019  checks  the  current  state  of  vertical  blanking  (VBL) 
on  the  Apple  He,  but  it  resets  the  latched  vertical  blanking  interrupt 
(VBlInt)  on  the  Apple  lie. 

$C02(HC02F 

On  the  Apple  II,  II  Plus,  and  He,  reading  any  address  $C02x  toggles 
the  cassette  output  signal.  On  the  original  Apple  lie,  both  reading 
from  and  writing  to  these  locations  are  reserved.  The  Apple  lie  with 
32K  of  ROM  uses  $C028  to  switch  in  or  out  the  extra  16K  of  ROM. 


§C030-$C03F 

On  all  Apple  II  series  computers,  reading  an  address  of  the  form 
$C03x  toggles  the  speaker.  For  full  Apple  II  series  compatibility, 
toggle  the  speaker  using  $C030,  and  reserve  $C031  through  $C03F. 

On  the  Apple  lie,  writing  to  $C031  through  $C03F  is  explicitly 
reserved. 


$C040-$C04F 

On  the  Apple  II,  II  Plus,  and  He,  reading  any  address  of  the  form 
$C04x  triggers  the  utility  strobe.  The  Apple  lie  has  no  utility  strobe. 

On  the  Apple  lie,  addresses  $C044  through  $C047  are  explicitly 
reserved,  and  reading  or  writing  any  address  from  $C048  through 
$C04F  resets  both  the  X  and  Y  mouse  interrupts  (Xlnt  and  YInt). 


$C050-$C05F 

Addresses  $C050  through  $C057  work  the  same  on  the  Apple  lie  as 
on  the  Apple  He:  they  turn  the  TEXT,  MIXED,  Page2,  and  HiRes 
switches  on  and  off 

On  the  Apple  He,  addresses  $C058  through  $C05F  turn  the 
annunciator  outputs  on  and  off.  On  an  Apple  He  with  a  revision  B 
main  logic  board  or  later,  an  Apple  Extended  80-Column  Text 
Card,  and  a  jumper  installed  on  the  card,  reading  locations  $C05E 
and  $C05F  set  and  clear  double  high-resolution  display  mode. 
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On  the  Apple  lie,  if  the  lOUDis  switch  is  on,  both  reading  from  and 
writing  to  addresses  $C058  through  $C05D  are  reserved,  and 
addresses  $C05E  and  $C05F  set  and  clear  the  double  high- 
resolution  display  (as  on  the  Apple  He  equipped  as  described  in  the 
preceding  paragraph).  If  the  lOUDis  switch  is  off,  then  addresses 
$C058  through  $C05F  control  various  characteristics  of  mouse  and 
vertical  blanking  interrupts  (Table  9-2). 

$C060^C06F 

On  the  Apple  lie,  writing  to  any  address  of  the  form  $C06x  is 
reserved,  and  reading  addresses  $C068  through  $C06f  is  reserved. 

Reading  addresses  $C06l  and  $C062  is  the  same  as  on  the  Apple  He 
(switch  inputs  and  Apple  keys).  Reading  addresses  $C064  and 
$C065  is  the  same  as  on  all  other  Apple  II  series  computers  (analog 
inputs  0  and  1). 

On  the  Apple  lie,  address  $C063  bit  7  is  1  if  the  mouse  switch  is  not 
pressed,  and  0  if  it  is  pressed,  so  that  software  looking  for  the  shift- 
key  mod  (used  on  Apple  II,  II  Plus,  and  He  with  some  text  cards)  will 
find  it  and  display  lowercase  correctly.  If  by  chance  the  mouse 
button  is  pressed  when  the  software  cheeks  location  $C063,  it  will 
appear  that  the  Shift-key  mod  is  not  present. 

On  the  Apple  He,  address  $C060  is  used  for  reading  the  state  of  the 
80/40  switch;  on  the  Apple  II,  II  Plus,  and  He,  this  address  is  for 
reading  cassette  input. 

The  Apple  He  has  two,  rather  than  four,  analog  (paddle)  inputs. 
Addresses  $C066  and  $C067  are  used  for  reading  the  mouse  X  and 
Y  direction  bits. 

$C07(>-$C07F 

On  the  Apple  II,  II  Plus,  and  He,  reading  from  or  writing  to  any 
address  of  the  form  $C07x  triggers  the  (analog  input)  paddle 
timers. 

On  the  Apple  He,  only  address  $C070  is  to  be  used  for  that  one 
function.  Addresses  $C071  through  $C07D  are  explicitly  reserved. 
The  results  of  reading  from  or  writing  to  addresses  $C07E  and 
$C07F  are  described  in  Table  5-8. 
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$C08a-$C08F 

On  the  Apple  He  and  lie,  accessing  addresses  in  this  range  selects 
different  combinations  of  bank-switched  memory  banks.  However, 
addresses  $C084  through  $C087  duplicate  the  functions  of  the  four 
addresses  preceding  them,  and  addresses  $C08C  through  $C08F  do 
also.  These  eight  addresses  are  explicitly  reserved  on  the  Apple  lie. 

$C090-$COFF 

On  the  Apple  II,  II  Plus,  and  He,  each  group  of  16  addresses  of  the 
form  $C080  +  $sO  is  allocated  to  an  interface  card  (if  present)  in 
slot  s. 

On  the  Apple  lie,  addresses  corresponding  to  slots  1,  2,  3,  4,  and  6 
are  allocated  to  a  serial  interface  card,  communication  interface 
card,  80-column  text  card,  mouse  interface  card,  and  disk 
controller  card,  respectively.  All  other  addresses  in  this  range  are 
reserved. 


Monitors 

The  older  models  of  the  Apple  II  and  Apple  II  Plus  included  a 
different  version  of  the  System  Monitor  from  the  one  built  into 
more  recent  models  (and  the  Apple  He  and  lie).  The  older  version, 
called  the  Monitor  ROM,  had  the  same  standard  I/O  subroutines  as 
the  newer  Autostart  ROM,  but  a  few  of  their  features  were  different; 
for  example,  there  were  no  arrow  keys  for  vertical  cursor  motion. 

When  you  start  the  Apple  lie  with  a  DOS  or  BASICS  disk  and  it  loads 
Integer  BASIC  into  the  bank-switched  area  in  RAM,  it  loads  the  old 
Monitor  along  with  it.  When  you  type  INT  from  Applesoft  to 
activate  Integer  BASIC,  you  also  activate  this  copy  of  the  old 
Monitor,  which  remains  active  until  you  either  type  FP  to  switch 
back  to  Applesoft,  which  uses  the  new  Monitor  in  ROM,  or  activate 
the  80-column  firmware. 
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I/O  in  general 

Apple  lie  I/O  is  different  from  I/O  on  the  Apple  II,  II  Plus,  and  He 
in  three  important  respects:  the  possibility  of  direct  memory  access 
(DMA)  transfers,  the  presence  or  absence  of  slots,  and  the 
presence  or  absence  of  built-in  interrupt  handling. 


DMA  transfers 

The  Apple  II,  II  Plus,  and  He  allow  DMA  transfers,  because  both  the 
address  and  the  data  bus  are  available  at  the  slots.  No  true  DMA 
transfer  is  possible  with  the  Apple  lie  because  neither  bus  is 
available  at  any  of  the  back  panel  connectors. 


Slots  versus  ports 

The  Apple  II  and  II  Plus  have  eight  identical  slots;  the  Apple  lie  has 
seven  identical  slots  plus  a  60-pin  auxiliary  slot  for  video,  add-on 
memory,  and  test  cards.  The  Apple  He  has  no  slots;  instead,  it  has 
back  panel  connectors  and  built-in  hardware  and  firmware  that  are 
functional  equivalents  of  slots  with  cards  in  them.  The  back  panel 
connectors  are  called  ports  on  the  Apple  lie. 


Interrupts 

The  Apple  lie  is  the  first  computer  in  the  Apple  II  series  to  have 
built-in  interrupt-handling  capabilities.  The  enhanced  Apple  He 
has  very  similar  interrupt-handling  capability  included. 


The  keyboard 

Both  keyboard  layout  and  character  sets  vary  in  the  Apple  II  series 
computers.  The  major  keyboard  difference  in  the  Apple  II  series  is 
that  the  Apple  lie  and  lie  have  full  ASCII  keyboards,  while  the 
Apple  II  and  II  Plus  do  not. 
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Keys,  switches,  and  lights 

The  Apple  II  and  II  Plus  have  identical  52-key  keyboards.  The 
Apple  He  and  Apple  lie  keyboards  have  the  same  63-key  full  ASCII 
keyboard  layout,  with  new  and  repositioned  keys  and  characters  as 
compared  to  the  Apple  II  and  II  Plus.  While  the  Apple  II  and  II  Plus 
have  a  Rept  key,  the  He  and  lie  have  an  auto-repeat  feature  built  into 
each  character  key. 

Some  Apple  II  and  Apple  II  Plus  machines  have  a  slide  switch  inside 
the  case,  under  the  keyboard  edge  of  the  cover,  for  selecting 
whether  or  not  Reset  works  without  Control.  On  the  Apple  He  and 
Apple  lie,  there  is  no  choice:  Control-Reset  works,  and  Reset  alone 
does  not. 

The  Apple  He  and  He  have  an  Open  Apple  and  a  Solid  Apple  key; 
the  Apple  n  and  n  Plus  do  not  have  these  two  keys. 

The  captions  on  several  keys — Escape,  Tab,  Control,  Shift,  Caps 
Lock,  Delete,  Return,  and  Reset — can  vary:  on  the  Apple  II  and 
II  Plus  some  are  abbreviated  or  missing;  on  the  Apple  He  all 
keycaps  are  lowercase  italic;  on  international  models,  some 
captions  are  replaced  by  symbols  (Appendix  G). 

The  Apple  lie  has  two  switches  that  the  other  models  do  not  have. 
One  switch  is  for  changing  between  40-eolumn  and  80-eolumn 
display,  the  other  is  for  selecting  keyboard  layout  (Sholes  versus 
Dvorak  on  USA  models),  or  both  keyboard  layout  and  character  set 
(on  international  models). 

The  position  of  the  power-on  light  differs  on  the  Apple  II  and 

II  Plus,  Apple  He,  and  Apple  lie.  The  Apple  He  has  a  disk-use  light 

as  well. 


Character  sets 

The  Apple  II  and  II  Plus  keyboard  character  sets  are  the  same.  They 
are  described  in  the  Apple  II  Reference  Manual. 

The  Apple  He  and  Apple  He  keyboard  character  sets  are  the  same: 
full  ASCII.  The  standard  (Sholes)  layout  and  key  assignments  are 
described  in  the  Apple  lie  Reference  Manual  The  Dvorak  layout 
and  key  assignments  are  described  in  Chapter  4  and  Appendix  G  of 
this  manual. 
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To  change  between  the  two  available  keyboard  layouts  requires 
modification  to  the  main  logic  board  on  the  Apple  He,  but  only 
toggling  of  the  keyboard  switch  on  the  Apple  lie. 

Apple  Computer,  Inc.,  manufactures  fully  localized  models  (with 
regard  to  power  supply  and  character  sets)  of  both  the  Apple  He  and 
the  Apple  lie.  However,  there  are  minor  variations  in  keyboard 
layout,  even  among  early  and  late  production  models  of  the  same 
machine.  For  further  details,  refer  to  Appendix  G  of  this  manual  or 
to  the  Apple  He  Supplement  to  the  Owner's  Manual. 


The  speaker 

The  Apple  lie  has  two  speaker  features  that  the  three  previous 
models  do  not  have.  They  are  a  two-channel,  but  monaural,  audio 
output  jack  for  headphones — ^which  disconnects  the  internal 
speaker  when  something  is  plugged  into  it — and  a  volume  control. 


The  video  display 

This  section  discusses  the  general  differences  between  Apple  lie 
video  display  capabilities  and  those  of  the  other  computers  in  the 
series.  Note,  however,  that  as  new  ROMs  become  available  for  the 
Apple  He,  many  differences  between  these  two  machines  will 
vanish. 


Character  sets 

The  Apple  II  and  II  Plus  display  only  uppercase  characters,  but  they 
display  them  in  three  ways:  normal,  inverse,  and  flashing.  The 
Apple  lie  and  He  can  display  uppercase  characters  in  all  three  ways, 
and  they  can  display  lowercase  characters  in  the  normal  way.  This 
combination  is  called  the  primary  character  set. 
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The  Apple  lie  and  He  have  another  character  set,  called  the 
alternate  character  set,  that  displays  a  full  set  of  normal  and  inverse 
uppercase  and  lowercase  characters,  but  can't  display  flashing 
characters.  The  primary  and  alternate  character  sets  are  described 
in  Chapter  5.  You  can  switch  character  sets  at  any  time  by  means  of 
the  AltChar  soft  switch,  also  described  in  Chapter  5. 

Flashing  display  must  not  be  used  with  the  enhanced  video  firmware 
active.  Use  it  in  40-column  mode  with  the  enhanced  video  firmware 
turned  off;  otherwise,  strange  displays  may  result,  such  as 
MouseText  characters  appearing  in  place  of  uppercase  letters. 

To  be  sure  of  compatibility  with  some  software,  you  have  to  switch 
the  Apple  lie  keyboard  to  uppercase  by  pressing  Caps  Lock. 


MouseText 

MouseText  characters  (Chapter  5)  are  available  on  every  Apple  lie, 
and  on  the  enhanced  Apple  He. 


Vertical  blanking 

A  signal  called  vertical  blanking  indicates  when  a  display  device 
should  stop  projecting  dots  until  the  display  mechanism  returns 
from  the  bottom  of  the  saeen  to  the  top  to  make  another  pass. 
During  this  interval,  a  program  can  make  changes  to  display 
memory  pages,  and  thus  provide  a  smooth,  flicker-free  transition 
to  a  new  display. 

On  the  Apple  lie,  vertical  blanking  (VBL)  is  a  signal  whose  level 
must  be  polled.  (VBL  is  not  available  to  software  on  the  Apple  II  or 
II  Plus.)  On  the  Apple  lie,  vertical  blanking  is  an  interrupt  (VBlInt) 
that  occurs  on  the  trailing  edge  of  the  active-low  VBL  signal. 
Programs  intended  to  run  on  all  Apple  II  series  computers  must  take 
this  difference  into  account. 


Display  modes 

All  models  have  40-column  text  mode,  low-resolution  graphics 
mode,  high-resolution  graphics  mode,  and  mixed  graphics  and 
text  modes.  The  Apple  He  (revision  B  motherboard)  with  an  Apple 
Extended  80-Column  Text  Card,  and  the  Apple  lie  have  double 
high-resolution  graphics  mode  also. 
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Disk  I/O 

The  Apple  II,  II  Plus,  and  He  can  support  up  to  six  disk  drives 
(although  four  is  the  recommended  maximum)  attached  in 
controller  cards  plugged  into  slots  6,  5,  and  4.  The  Apple  lie 
supports  up  to  two  disk  drives:  its  built-in  drive  (treated  as  slot  6, 
drive  1),  and  one  external  disk  drive  (treated  as  slot  6,  drive  2;  also 
treated  as  slot  7,  drive  1  under  ProDOS)  for  external-drive  startup 
purposes. 


UniDisk  3.5     The  Apple  lie  with  UnlDisk  3.5  support  does  not  use  slot  7, 
drive  1  for  external  drives.  They  are  handled  through  the 
Smartport  described  In  Chapter  6.  The  firmware  for  slot  7  ($C7xx) 
Is  needed  for  other  parts  of  the  firmware. 


Serial  I/O 

The  Apple  lie  serial  ports  (ports  1  and  2)  are  similar  to  Super  Serial 
Cards  installed  in  slots  1  and  2  of  an  Apple  He.  The  serial  port 
commands  are  a  slightly  modified  subset  of  Super  Serial  Card 
commands.  This  subset  includes  all  the  commands  supported  by 
the  earlier  Apple  Serial  Interface  Card  and  Communication  Card. 


Serial  ports  versus  serial  cards 

There  are  several  important  differences  between  Apple  lie  serial 
ports  and  other  Apple  II  series  computers  with  serial  cards  installed 
in  them. 

Apple  He  serial  ports  have  no  switches.  Instead,  initial  values  are 
moved  from  firmware  locations  into  auxiliary  memory  when  the 
power  is  turned  on.  Changes  made  to  these  values  in  auxiliary 
memory  remain  in  effect  until  the  power  is  turned  off.  Pressing 
Open  Apple-Control-Reset  does  not  change  them. 

When  the  port  itself  is  turned  on  (with  an  IN  or  PR  command),  the 
initial  values  in  auxiliary  memory  are  placed  in  the  main  memory 
screen  holes  assigned  to  the  port.  These  characteristics  can  be 
changed  by  the  port  commands.  The  changed  characteristics 
remain  in  effect  until  the  port  is  turned  off  and  then  on  again  (with 
PR  and  IN  commands). 
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The  command  syntax  for  the  Apple  He  ports  also  differs  from  the 
syntax  for  serial  cards.  A  separate  command  character,  Control-A 
or  Control-I,  must  precede  each  individual  port  command, 
whereas  several  commands  to  a  serial  card  can  be  strung  together 
between  the  command  character  and  a  carriage  return  character. 

The  letters  used  for  some  of  the  commands  have  been  changed 
from  those  used  with  the  Super  Serial  Card  (such  as  S  instead  of  B  for 
sending  a  BREAK  signal).  Each  serial  port  command  letter  is 
unique,  to  simplify  command  interpretation. 

Changing  the  command  character  from  Control-A  to  Control-I,  or 
vice  versa,  makes  the  Super  Serial  Card  change  from 
communication  mode  to  printer  mode  and  back;  this  is  not  the  case 
with  Apple  lie  serial  ports.  With  the  Apple  lie,  use  the  System 
Utilities  disk  to  change  modes. 

Super  Serial  Card  commands  support  some  functions  that  Apple  lie 
serial  port  commands  don't  support:  translating  incoming 
characters,  such  as  changing  lowercase  to  uppercase  (for  the  benefit 
of  the  Apple  II  or  II  Plus);  delaying  after  sending  carriage  return, 
line  feed,  or  form  feed,  and  so  on. 


UniDisk  3.5     Several  nesn  serial  port  commands  are  available  on  the 

Apple  lie  mM\  UniDisk  3.5  support.  These  commands  have  been 
added  to  make  It  easier  to  v/rlte  programs  that  are  also 
compatible  with  the  Super  Serial  Card.  See  Chapters  7  and  8  for 
these  new  commands. 

Following  a  Control-I  nnnN  command,  the  Apple  lie  automatically 
generates  a  carriage  return  after  nnnN  characters;  with  the  Super 
Serial  Card,  you  need  to  turn  this  on  with  Control-I  C. 


Serial  I/O  buffers 

The  communication  port  firmware  uses  auxiliary  memory  page  $08 
as  an  input  and  output  buffer.  By  doing  so,  the  firmware  can  keep  up 
with  higher  baud  rates.  It  can  also  hide  data  from  the  Monitor, 
Applesoft,  and  other  system  software. 

Programs  written  for  the  Apple  He  or  lie  can,  of  course,  store 
information  in  auxiliary  memory  page  $08.  However,  such 
information  is  destroyed  when  the  communication  port  is 
activated. 
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Mouse  and  hand  controllers 

The  DB-9  back  panel  connector  on  the  Apple  lie  is  used  for  both 
the  mouse  and  hand  controllers.  On  the  Apple  lie,  the  DB-9 
connector  supports  hand  controllers  only,  the  mouse  must  use  the 
connector  on  the  interface  card. 


Mouse  input 

The  Apple  lie  provides  built-in  firmware  support  for  a  mouse 
connected  to  the  DB-9  mouse  and  hand  controller  connector. 
Apple  lie  mouse  support  includes  mouse  movement  and  button 
interrupts  (and  vertical  blanking  interrupts  for  synchronization  with 
the  display);  Apple  He  mouse  support  relies  on  polling  VBL  instead 
of  vertical  blanking  interrupts. 

As  a  result  of  how  interrupts  are  handled  on  the  two  machines,  the 
mouse  firmware  routine  calls  function  somewhat  differently  for  the 
Apple  lie  and  Apple  He.  However,  using  the  calls  in  the  manner 
described  in  Chapter  9  ensures  mouse  support  compatibility 
between  the  two  machines.  The  ratio  of  mouse  movement  to  cursor 
movement  is  different  on  the  Apple  lie  from  on  the  Apple  He. 


Hand  controller  input  and  output 

The  Apple  II,  II  Plus,  and  He  have  a  l6-pin  game  I/O  connector 
inside  the  case  that  supports  three  switch  inputs,  four  analog 
(paddle)  inputs,  and  four  annunciator  outputs.  The  Apple  He  and 
Apple  lie  have  a  DB-9  back  panel  connector  that  supports  the  three 
switch  inputs  and  two  paddle  inputs  (plus  two  more  on  the  internal 
GAME  I/O  connector  of  the  Apple  II,  II  Plus,  and  lie). 

The  Apple  lie  does  not  support  the  four  annunciator  outputs. 

The  characteristic  response  curve  for  hand  controllers  differs  for 
the  Apple  lie  from  that  of  the  Apple  II,  II  Plus,  and  He.  Compare 
Figure  F-1  with  Figure  11-42.  This  was  done  so  the  hardware  would 
support  identifiable  mouse  and  hand  controller  signals  using  the 
same  circuits. 
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The  paddle-timing  circuit  on  the  Apple  II  Plus  is  slightly  different 
from  the  one  on  the  Apple  He  and  lie.  On  the  Apple  He  and  lie  the 
100-ohm  fixed  resistor  is  between  the  NE556  discharge  lead  and  the 
capacitor;  the  variable  resistor  in  the  paddle  is  connected  directly 
to  the  capacitor.  On  the  Apple  II  Plus,  the  capacitor  is  connected 
directly  to  the  discharge  lead,  and  the  fixed  resistor  is  in  series  with 
the  paddle  resistor. 
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Figure  F-1 

Apple  II,  II  Plus,  and  He  hand  controller  signals 


Cassette  I/O 

The  Apple  11,  II  Plus,  and  He  all  have  cassette  input  and  output 
jacks,  memory  locations,  and  Monitor  support.  The  Apple  lie  does 
not. 


UniDisk  3.5      If  you  plan  to  run  a  program  on  your  Apple  lie  that  handles 
cassette  I/O,  make  sure  that  it  does  not  access  $C028.  The 
Apple  He  with  UniDisk  3.5  support  uses  address  $C028  to  toggle 
between  its  two  16K  banks  of  memory. 
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Hardware 

Besides  the  different  microprocessors  used  in  various  models  in  the 
Apple  II  series,  there  are  important  differences  in  power 
specifications  and  custom  chips. 


Power 

The  power  supplies  for  the  Apple  II,  II  Plus,  and  He  are  essentially 
the  same.  The  floor  transformer  and  voltage  converter  for  the 
Apple  lie  have  smaller  capacity  for  current  and  heat  dissipation. 
Therefore,  it  is  important  to  observe  the  load  limits  specified  in 
each  of  the  reference  manuals. 


Custom  chips 

The  Apple  He  custom  chips  (memory  management  unit  and 
input/output  unit)  replaced  dozens  of  Apple  11  Plus  chips,  and 
added  the  functionality  of  dozens  more.  The  Apple  lie  has  custom 
MMU  and  lOU  chips,  too,  but  they  represent  different  bonding 
options,  and  so  their  pin  assignments  are  not  compatible. 

In  addition,  the  Apple  lie  has  a  custom  general  logic  unit  (GLU), 
timing  generator  (TMG),  and  disk  controller  unit  (also  known  as  an 
Integrated  Woz  Machine,  or  IWM).  The  Apple  lie  has  two  hybrid 
units  (AUD  and  VID)  for  audio  and  video  amplification. 
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Appendix  G 


USA  and  International  Models 


This  appendix  repeats  some  of  the  keyboard  information  given  in 
Chapter  4  for  the  two  USA  keyboard  layouts,  for  easy  comparison 
with  the  other  layouts  available.  Following  these  is  a  composite 
table  of  the  ASCII  codes  and  the  characters  associated  with  them  on 
all  the  models  discussed. 


Keyboard  layouts  and  codes 

Each  of  the  following  subsections  has  a  keyboard  illustration  and  a 
table  of  the  codes  that  result  from  the  possible  keystrokes.  Note, 
however,  that  Table  G-1  is  the  basic  table  of  keystrokes  and  their 
codes.  For  simplicity,  subsequent  tables  (up  to  Table  G-7)  list  only 
the  keystrokes  and  codes  that  differ  from  those  in  Table  G-1. 

For  example,  pressing  the  A  key  produces  a  (hexadecimal  6l); 
pressing  Shift-A  produces  uppercase  A  (hexadecimal  41);  pressing 
Control-A  or  Control-Shift-A  produces  SOH  (the  ASCII  Start  Of 
Header  control  character,  hexadecimal  01).  You  can  tell  that  this 
key  has  the  same  effect  on  all  keyboards  because  nothing  appears  in 
Tables  G-2  through  G-7  for  that  key. 

A  quick  way  to  find  out  which  characters  in  the  ASCII  set  change  on 
international  keyboards  is  to  check  Table  G-8.  In  fact,  only  a  few  of 
them  change.  The  pairing  of  characters  on  keys  varies  more. 
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♦  Note:  On  all  but  the  French  and  Italian  keyboards,  Caps  Lock 
affects  only  keys  that  can  produce  both  lowercase  letters  (with  or 
without  an  accent)  and  their  uppercase  equivalents.  With  these 
keys,  Caps  Lock  down  is  equivalent  to  holding  down  Shift, 
resulting  in  uppercase  instead  of  lowercase.  If  a  key  produces 
only  a  lowercase  version  of  an  accented  letter,  then  Caps  Lock 
does  not  affect  it. 

On  the  French  and  Italian  keyboards,  Caps  Lock  shifts  all  the 
keys.  Furthermore,  on  the  French  keyboard,  when  Caps  Lock  is 
down  the  Shift  key  undoes  the  shifting. 

The  shapes  and  arrangement  of  keys  in  Figures  G-1  and  G-2  follow 
the  ANSI  (American  National  Standards  Institute)  standard,  which  is 
used  mainly  in  North  and  South  America.  The  shapes  and 
arrangement  of  keys  in  Figure  G-3  follow  the  ISO  (International 
Standards  Organization)  standard  used  in  Europe  and  elsewhere. 

The  only  differences  between  the  ANSI  and  ISO  versions  of  the  USA 
keyboard  are 

D  the  shapes  of  three  keys:  the  left  Shift  key.  Caps  Lock,  and  Return 

D  the  resulting  repositioning  of  two  keys  ( I  and  ~)  in  Figures  G-1 
and  G-3 

D  for  some  countries,  the  arrow  symbols  on  Tab,  Caps  Lock, 
Return,  and  the  two  Shift  keys  (as  shown  in  Figure  G-3) 


USA  standard  (Sholes)  keyboard 

Figure  G-1  shows  the  standard  (Sholes)  keyboard  as  it  is  laid  out  for 
USA  models  of  the  Apple  lie  with  the  keyboard  switch  up.  Table  G-1 
lists  the  ASCII  codes  resulting  from  all  simple  and  combination 
keystrokes  on  this  keyboard. 
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jresei    /        jJsoMO  Ilk 


keyboard 


I  disk  use  I  power 


esc 

1 
/ 

m 
2 

# 

3 

$ 
4 

%          ^          &          * 
5          6           7           8 

( 
9 

)             - 
0 

+ 

=            delete 

tat 

Q 

W 

E 

R 

T 

Y 

U 

I 

0 

P 

[           } 
[           ] 

1 
\ 

control 

A 

s 

0 

F 

G 

H 

J 

K 

/             /             '             return 

shift 

Z 

X 

C 

<          >          ? 
V          B          N          M         .            .            1 

shift 

caps 
lock 

\ 

a 

«          ^..        -^        i          t 

Figure  G-1 

USA  standard  (or  Sholes)  keyboard,  keyboard  switch  up 

Table  G-1 

Keys  and  ASCII  codes 


Key  alone         +  Control  +  Shift 


+  Botti 


Key 

Code 

Ctiar 

Code 

Ctiar 

Code 

Ctiar 

Code 

Ctiar 

Delete 

7F 

DEL 

7F 

DEL 

7F 

DEL 

7F 

DEL 

Left  Arrow 

08 

BS 

08 

BS 

08 

BS 

08 

BS 

Tab 

09 

HT 

09 

HT 

09 

HT 

09 

HT 

Down  Arrow 

OA 

LF 

OA 

LF 

OA 

LF 

OA 

LF 

Up  Arrow 

OB 

VT 

OB 

VT 

OB 

VT 

OB 

VT 

Return 

OD 

CR 

OD 

CR 

OD 

CR 

OD 

CR 

Right  Arrow 

15 

NAK 

15 

NAK 

15 

NAK 

15 

NAK 

Escape 

IB 

ESC 

IB 

ESC 

IB 

ESC 

IB 

ESC 

Space 

20 

SP 

20 

SP 

20 

SP 

20 

SP 

1  If 

27 

( 

27 

1 

22 

fl 

22 

tl 

,  < 

2C 

) 

20 

1 

3C 

< 

3C 

< 

- 

2D 

- 

IF 

US 

5F 

IF 

US 

.  > 

2E 

2E 

3E 

> 

3E 

> 

/  ? 

2F 

/ 

2F 

/ 

3F 

? 

3F 

7 

0) 

30 

0 

30 

0 

29 

) 

29 

) 

1  ! 

31 

1 

31 

1 

21 

! 

21 

I 

2® 

32 

2 

00 

NUL 

40 

@ 

00 

NUI 

3# 

33 

3 

33 

3 

23 

# 

23 

# 
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Table  G-1 

(continued) 

Keys  and  ASCII  codes 

Key  alone 
Code  Char 

+  Control 

+  Shift 

+  Both 

Key 

Cod€ 

»  Char 

Code  Char 

Code 

!  Char 

4$ 

34 

4 

34 

4 

24 

$ 

24 

$ 

5% 

35 

5 

35 

5 

25 

% 

25 

% 

6a 

36 

6 

IE 

RS 

5E 

A 

IE 

RS 

7& 

37 

7 

37 

7 

26 

& 

26 

& 

8  * 

38 

8 

38 

8 

2A 

* 

2A 

>f> 

9( 

)     ■ 

39 
3B 

9 

39 
3B 

9 

28 
3A 

c 

28 
3A 

( 

=    + 

3D 

= 

3D 

= 

2B 

+ 

2B 

+ 

[{ 

5B 

[ 

IB 

ESC 

7B 

{ 

IB 

ESC 

\  1 

5C 

\ 

IC 

FS 

7C 

1 

IC 

FS 

]} 

5D 

] 

ID 

GS 

7D 

} 

ID 

GS 

!  ~ 

60 

! 

60 

I 

7E 

~ 

7E 

~ 

A 

61 

a 

01 

SOH 

41 

A 

01 

SOH 

B 

62 

b 

02 

STX 

42 

B 

02 

STX 

C 

63 

c 

03 

ETX 

43 

C 

03 

ETX 

D 

6A 

d 

04 

EOT 

AA 

D 

04 

EOT 

E 

65 

e 

05 

ENQ 

45 

E 

05 

ENQ 

F 

66 

f 

06 

ACK 

A6 

F 

06 

ACK 

G 

61 

8 

07 

BEL 

47 

G 

07 

BEL 

H 

68 

h 

08 

BS 

48 

H 

08 

BS 

I 

69 

i 

09 

HT 

49 

I 

09 

HT 

J 

6A 

J 

OA 

LF 

4A 

J 

OA 

LF 

K 

6b 

k 

OB 

VT 

4B 

K 

OB 

VT 

L 

6C 

1 

OC 

FF 

4C 

L 

OC 

FF 

M 

6D 

m 

OD 

CR 

4D 

M 

OD 

CR 

N 

6e 

n 

OE 

SO 

4E 

N 

OE 

SO 

O 

6f 

o 

OF 

SI 

4F 

O 

OF 

SI 

P 

70 

P 

10 

DLE 

50 

P 

10 

DLE 

Q 

71 

q 

11 

DCl 

51 

Q 

11 

DCl 

R 

72 

r 

12 

DC2 

52 

R 

12 

DC2 

S 

73 

s 

13 

DC3 

53 

S 

13 

DC3 

T 

74 

t 

14 

DC4 

54 

T 

14 

DC4 

U 

75 

u 

15 

NAK 

55 

U 

15 

NAK 

V 

76 

V 

16 

SYN 

56 

V 

16 

SYN 

W 

77 

w 

17 

ETB 

57 

W 

17 

ETB 

X 

78 

X 

18 

CAN 

58 

X 

18 

CAN 

Y 

79 

y 

19 

EM 

59 

Y 

19 

EM 

Z 

7A 

z 

lA 

SUB 

5A 

z 

lA 

SUB 

Note:  Codes 

are  in  hexadecimal  here 

;  refer  to  Table  G-8  for  decimal 

equivalents. 
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USA  simplified  (Dvoralc)  keyboard 

Figure  G-2  shows  the  Dvorak  layout  of  the  USA  keyboard. 
Characters  are  paired  up  on  keys  in  exactly  the  same  way  as  on  the 
USA  standard  keyboard;  only  individual  key  positions  are  changed. 
In  fact,  you  can  change  the  keycap  arrangement  to  match 
Figure  G-2,  lock  the  keyboard  switch  in  its  down  position,  and  have 
a  working  Dvorak  keyboard.  All  keystrokes  produce  the  same  ASCII 
codes  as  those  shown  in  Table  G-1. 


I  reset    /         lj80/40  11  h 


keyboard 


I  disk  use  I  power 


esc 

1 
1 

2 

# 
3 

$ 
4 

% 
5 

6 

A           *          1 
7           8           9 

1          [          } 

0           I           ] 

delete 

tab 

II 
1 

< 

> 

P 

Y 

F 

G 

C 

R 

L 

7 
/ 

+             1 
\ 

control 

A 

0 

E 

U 

1 

D 

H 

T 

N 

S 

— 

return 

shift 

: 

0 

J 

K 

X          B          M         W         V          Z          shift 

caps 
lock 

\ 

C5                                                                      «         ^-        -^        i          t 

Figure  G-2 

USA  simplified  (or  Dvorak)  keyboard,  keyboard  switch  down 
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ISO  layout  of  USA  keyboard 

Figure  G-3  shows  the  layout  of  all  ISO  European  keyboards  (except 
the  Italian  keyboard)  when  the  keyboard  switch  is  up.  All  keystrokes 
produce  the  same  ASCII  codes  as  those  shown  in  Table  G-1. 


I  reset    /         U 80/40  jjiiii 


/n   /© 


esc 

1 

m 
2 

# 
3 

$ 
4 

% 
5 

6 

6  *         f          J          -        + 

7  8            9            0-           =           delete 

-^ 

0 

1/1/ 

E 

R 

T 

Y 

U 

1 

0 

P 

[ 
[ 

} 
] 

^ 

control 

A 

S 

D 

F 

G 

H 

J 

K 

I 

; 

1 

\ 

O 

1 
\ 

<          >          ? 
Z         X         C         V          B         N         M         ,           .           /          o 

O 

d                                                                 «         ^-        -^       4^         t 

Figure  G-3 

ISO  version  of  USA  standard  l<eyboard,  i<eyboard  switchi  up 
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English  keyboard 

With  the  keyboard  switch  up,  the  English  model  of  the  Apple  lie 
keyboard  layout  is  as  shown  in  Figure  G-3,  and  keystrokes  produce 
the  ASCII  codes  shown  in  Table  G-1. 

With  the  keyboard  switch  down,  the  English  model  keyboard  layout 
is  as  shown  in  Figure  G-4.  The  change  in  ASCII  code  production 
(from  that  in  Table  G-1)  is  shown  in  Table  G-2. 

The  only  changed  character  is  the  substitution  of  the  British  pound- 
sterling  symbol  (£)  for  the  cross-hatch  symbol  (#)  on  the  shifted 
3-key. 


I  reset    /        IIbomo  IJUU 


/n   /© 


esc 

1 
) 

2 

£          S          %          ^          &          *          (           J           —        + 

3           4           5           6           7           8           9           0           -          =          ilelete 

tab 

Q 

W 

E 

R 

T          Y          U         1 

0 

P 

{ 
[ 

J 
] 

return 

control 

A 

S 

D 

F 

G 

H 

J 

K 

L            ':             '             ' 

shift 

\ 
\ 

<          >          ? 
Z         X         C         V          B         N         M        .           .           /shift 

caps 
lock 

d 

« 

<-■■ 

■^         4           t 

Figure  G-4 

English  keyboard,  keyboard  switch  down 


Table  G-2 

English  keyboard  code  differences  from  Table  G-1 


Key  alone  +  Control 


+  Shift 


+  Both 


Key        Code      Char     Code      Char     Code      Char      Code      Char 


3£        33 


33 


23 


23 


Note:  Codes  are  in  hexadecimal  here;  refer  to  Table  G-8  for  decimal 
equivalents. 
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French  keyboard 

With  the  keyboard  switch  up,  the  French  model  of  the  Apple  lie 
keyboard  layout  is  as  shown  in  Figure  G-3,  and  keystrokes  produce 
the  ASCII  codes  shown  in  Table  G-1. 

With  the  keyboard  switch  down,  the  French  model  keyboard  layout 
is  as  shown  in  Figure  G-5.  The  changes  in  ASCII  code  production 
(from  that  in  Table  G-1)  are  shown  in  Table  G-3. 

Note  that  on  the  French  keyboard.  Caps  Lock  shifts  to  the  upper 
characters  on  all  keys.  With  Caps  Lock  on.  Shift  "unshifts"  to  the 
lower  character  on  any  key  pressed  with  it. 


I  reset    /        IJsoMO  11  US 


/n   /® 


esc 

/ 

2 
e 

3 
II 

4 
1 

5           6           7           8           9           0"           _ 

(             §            e             !             i;            a             )             -           delete 

-H 

A 

I 

E 

R 

T 

Y 

U 

/ 

0 

P 

y\ 

■X- 
$ 

^ 

control 

Q 

S 

D 

F 

G 

H 

J 

K 

%          £ 
L          M        u          ' 

•£> 

> 
< 

W 

X 

C 

V 

B 

N 

? 

: 

1 

-1- 

O 

O 

6 

« 

^■■ 

-^        i          t 

Figure  G-5 

French  keyboard,  keyboard  switch  down 
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Table  G-3 

French  keyboard  code  differences  from  Table  G-1 


Key  alone 
Code      Char 

+  Control 

+ 

Shift 

+ 

Both 

Key 

Code 

Char 

Code 

Char 

Code 

Char 

&1 

26 

& 

26 

& 

31 

1 

31 

1 

62 

7B 

e 

7B 

6 

32 

2 

32 

2 

"3 

22 

(( 

22 

II 

33 

3 

33 

3 

'4 

27 

1 

27 

1 

34 

4 

34 

4 

(5 

28 

( 

28 

( 

35 

5 

35 

5 

$6 

5D 

S 

ID 

GS 

36 

6 

ID 

GS 

hi 

7D 

e 

7D 

t 

37 

7 

37 

7 

!8 

21 

! 

21 

! 

38 

8 

38 

8 

?9 

5C 

f 

IC 

FS 

39 

9 

IC 

FS 

ilO 

40 

i 

00 

NUL 

30 

0 

00 

NUL 

)** 

29 

) 

IB 

ESC 

5B 

o 

IB 

ESC 

A  •• 

5E 

A 

IE 

RS 

7E 

IE 

RS 

$    * 

24 

$ 

24 

$ 

2A 

* 

2A 

♦ 

U% 

7C 

U 

7C 

u 

25 

% 

25 

% 

^£ 

60 

" 

60 

- 

23 

£ 

23 

£ 

<  > 

3C 

< 

3C 

3E 

> 

3E 

> 

7 

t      • 
t     ■• 

2C 
3B 

1 

2C 
3B 

1 

3F 
2E 

? 

3F 

2E 

? 

:/ 

3A 

3A 

: 

2F 

/ 

2F 

/ 

Atote;  Codes  are  in  hexadecimal  here;  refer  to  Table  G-8  for  decimal 
equivalents. 
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Canadian  keyboard 

With  the  keyboard  switch  up,  the  Canadian  model  of  the  Apple  lie 
keyboard  layout  is  as  shown  in  Figure  G-1,  and  keystrokes  produce 
the  ASCII  codes  shown  in  Table  G-1. 

With  the  keyboard  switch  down,  the  Canadian  model  keyboard 
layout  is  as  shown  in  Figure  G-6.  The  changes  in  ASCII  code 
production  (from  that  in  Table  G-1)  are  shown  in  Table  G-4. 


I  reset    /        jj 80/40  jjiiii 


hh 


esc 

1 
/ 

2 

3 

$ 
4 

% 
5 

6 

& 
7 

*         f          J          -        + 

8            9            0-           =           delete 

tat 

a 

W 

E 

R 

T 

Y 

U 

1            0 

P 

[  e 
[a 

]  ^      \    ? 
]u       \   ^ 

control 

A 

s 

D 

F 

G 

H 

J 

K 

L 

1 

return 

shift 

Z 

X 

C 

V 

B 

<           >           ?  C 

N          M         ,           .           1  e       shift 

caps 
lock 

a                                                 «       ^-      -^      i       t 

Figure  G-6 

Canadian  i<eyboard,  l<eyboard  switcli  down 


Table  G-4 

Canadian  l<eyboard  code  differences  from  Table  G-1 


Key  alone 
Code     Char 

+  Control 

+ 

Shift 

+ 

Both 

Key 

Code 

Char 

Code 

Char 

Code 

Char 

2" 

32 

2 

00 

NUL 

5B 

0 

00 

NUL 

3£ 

33 

3 

33 

3 

23 

£ 

23 

£ 

6S 

36 

6 

RS 

IE 

5D 

§ 

RS 

IE 

\h 

40 

a 

7F 

DEL 

7D 

e 

7F 

DEL 

UA 

7C 

U 

7C 

t 

5E 

A 

5E 

A 

"    ? 

60 

^ 

ESC 

IB 

3F 

? 

ID 

GS 

6? 

7B 

e 

IC 

FS 

5C 

? 

IC 

FS 

"/ 

7E 

n 

7E 

» 

2F 

/ 

2F 

/ 

Note:  Codes  are  in  hexadecimal  here;  refer  to  Table  G-8  for  decimal 
equivalents. 
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German  keyboard 

With  the  keyboard  switch  up,  the  German  model  of  the  Apple  lie 
keyboard  layout  is  as  shown  in  Figure  G-3,  and  keystrokes  produce 
the  ASCII  codes  shown  in  Table  G-1. 

With  the  keyboard  switch  down,  the  German  model  keyboard  layout 
is  as  shown  in  Figure  G-1.  The  change  in  ASCII  code  production 
(from  that  in  Table  G-1)  is  shown  in  Table  G-5. 


I  reset    /        IJsomo  jjini 


/n   /® 


% 

5 


delete 


-^ 


w 


z 


+ 


^ 


control 


D 


H 


# 


o 


> 

< 


N 


M 


i> 


O 


G 


igure  G-7 

German  keyboard,  keyboard  switch  down 
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Table  G-5 

German  keyboard  code  differences  from  Table  G-1 


Key  alone 
Code      Char 

+  Control 

+ 

Shift 

+ 

Both 

Key 

Code 

Char 

Code 

Char 

Code 

Char 

2" 

32 

2 

32 

2 

22 

II 

22 

II 

3§ 

33 

3 

00 

NUL 

40 

§ 

00 

NUL 

6& 

36 

6 

36 

6 

26 

& 

26 

& 

7/ 

37 

7 

37 

7 

2F 

/ 

2F 

/ 

8( 

38 

8 

38 

8 

28 

( 

28 

( 

9) 

39 

9 

39 

9 

29 

) 

29 

) 

0  = 

30 

0 

30 

0 

3D 

= 

3D 

= 

13  ? 

7E 

1§ 

7E 

£ 

3F 

? 

3F 

7 

U 

7D 

U 

ID 

GS 

5D 

U 

ID 

GS 

+  • 

2B 

+ 

2B 

+ 

2A 

* 

2A 

* 

O 

7C 

o 

IC 

FS 

5C 

o 

IC 

FS 

A 

7B 

A 

IB 

ESC 

5B 

A 

IB 

ESC 

#  A 

23 

# 

IE 

RS 

5E 

A 

IE 

RS 

<   > 

1        ) 

3C 
2C 

2E 

< 

3C 
2C 

2E 

< 

» 

3E 
3B 
3A 

> 
» 

3E 
3B 
3A 

> 

» 

Note:  Codes  are  in  hexadecimal  here;  refer  to  Table  G-8  for  decimal 
equivalents. 
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Italian  keyboard 

With  the  keyboard  switch  down,  the  Italian  model  keyboard  layout  is 
as  shown  in  Figure  G-8.  The  change  in  ASCII  code  production  (from 
that  in  Table  G-1)  is  shown  in  Table  G-6. 

With  the  keyboard  switch  up,  the  Italian  model  keyboard  produces 
exactly  the  same  ASCII  codes  for  each  key,  but  what  is  displayed 
differs  for  the  ten  characters  indicated  with  the  circled  numbers  0, 
2-5,  and  7-11  in  Table  G-8. 


I  reset    /         llsoMO  IJiia 


/b    /© 


esc 

1 
& 

2 
II 

3           4           5           6           7           8           9           0           —         + 

'             (            C            e            )            £           a            e            -           =           delete 

-H 

0 

Z 

E 

R 

T 

Y 

U 

1 

0 

P 

) 

$ 

<J 

control 

A 

s 

D 

F 

G 

H 

J 

K 

L          M 

I 

u          § 

>                                                                                     ?            .             /           ! 
o           <         W        X         C         V         B         N         ,          :          :          bo 

O 

d                                                          «        ^-       -^       i        T 

Figure  G-8 

Italian  keyboard,  keyboard  switch  dowri 
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Table  G-6 

Italian  keyboard  code  differences  from  Table  G-1 


Key  alone 
Code      Char 

+  Control 

+ 

Shift 

+ 

Both 

Key 

Code 

Char 

Code 

Char 

Code 

Char 

&1 

26 

& 

26 

& 

31 

1 

31 

1 

"2 

22 

ft 

22 

tt 

32 

2 

32 

2 

'3 

27 

1 

27 

! 

33 

3 

33 

3 

(4 

28 

( 

28 

( 

34 

4 

34 

4 

f5 

5C 

? 

IC 

FS 

35 

5 

IC 

FS 

e6 

7D 

6 

7D 

6 

36 

6 

36 

6 

)7 

29 

) 

29 

) 

37 

7 

37 

7 

£8 

23 

£, 

23 

£ 

38 

8 

38 

8 

a9 

7B 

a 

7B 

a 

39 

9 

39 

9 

eO 

5D 

e 

ID 

GS 

30 

0 

ID 

GS 

lA 

7E 

I 

IE 

RS 

5E 

A 

IE 

RS 

$  * 

24 

$ 

24 

$ 

2A 

* 

2A 

* 

u% 

60 

u 

60 

u 

25 

% 

25 

% 

§" 

40 

§ 

00 

NUL 

5B 

o 

IB 

ESC 

<  > 

3C 

< 

3C 

< 

3E 

> 

3E 

> 

7 

)    • 

2C 
3B 

2C 
3B 

3F 
2E 

? 

3F 
2E 

? 

:  / 

3A 

: 

3A 

2F 

/ 

2F 

/ 

6  ! 

7C 

6 

7C 

6 

21 

! 

21 

I 

Note:  Ccxles  are  in  hexadecimal  here;  refer  to  Table  G-8  for  decimal 
equivalents. 
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Western  Spanish  keyboard 

With  the  keyboard  switch  up,  the  Western  (that  is,  American) 
Spanish  model  of  the  Apple  lie  keyboard  layout  is  as  shown  in 
Figure  G-1,  and  keystrokes  produce  the  ASCII  codes  shown  in 
Table  G-1. 

With  the  keyboard  switch  down,  the  Western  Spanish  model 
keyboard  layout  is  as  shown  in  Figure  G-9.  The  change  in  ASCII 
code  production  (from  that  in  Table  G-1)  is  shown  in  Table  G-7. 


I  reset    /        IJaom  ^JUU 


/n   /© 


esc 

/ 
; 

i 
2 

£ 
3 

$ 
4 

% 
5 

/ 
6 

& 
1 

8 

( 
9 

0 

— 

-1- 

delete 

-H 

Q 

W 

E 

R 

T 

Y 

U         1 

0 

P 

0  /\ 

1  \ 

£ 

control 

A 

S 

D 

F 

G 

H 

J 

K 

/ 

N           ';             <=> 

i> 

Z 

/ 

C 

V 

B 

N 

M 

7 

! 

^ 

> 

< 

d 

n       <--      -^      i       t 

Figure  G-9 

Western  Spanish  keyboard,  keyboard  switch  down 
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Table  6-7 

Western  Spanish  keyboard  code  differences  from  Table  G-1 


Key  alone 
Code     Char 

+  Control 

+ 

Shift 

+ 

Both 

Key 

Code 

Char 

Code 

Char 

Code 

Char 

1  i 

31 

1 

31 

1 

5B 

i 

5B 

i 

2i 

32 

2 

32 

2 

5D 

i 

5D 

i 

3£ 

33 

3 

33 

3 

23 

&. 

23 

6/ 

36 

6 

36 

6 

2F 

/ 

2F 

/ 

'  o 

27 

" 

27 

' 

7B 

o 

7B 

o 

"A 

60 

^ 

00 

NUL 

5E 

A 

00 

NUL 

~   § 

7E 

~ 

7F 

DEL 

40 

§ 

7F 

DEL 

N 

7C 

N 

IC 

FS 

5C 

N 

IC 

FS 

I 

2C 

2E 

) 

2C 
2E 

» 

3F 
21 

I 

3F 
21 

p 
I 

9" 

7D 

f 

ID 

GS 

22 

II 

ID 

GS 

<  > 

3C 

< 

IE 

RS 

3E 

> 

IE 

RS 

Note:  Codes  are  in  hexadecimal  here;  refer  to  Table  G-8  for  decimal 
equivalents. 


ASCII  character  sets 

Table  G-8  lists  the  ASCII  (American  National  Standard  Code  for 
Information  Interchange)  codes  that  the  Apple  lie  uses,  as  well  as 
the  decimal  and  hexadecimal  equivalents.  Where  there  are 
differences  between  character  sets,  an  asterisked  number  in  the 
main  table  refers  to  a  column  in  the  following  part  of  the  table. 


Table  G-8 

ASCII  code  equivalents 

ASCII    Dec 

Hex 

ASCII  Dec 

Hex 

ASCII 

Dec 

Hex 

ASCII 

Dec 

Hex 

NUL     00 

00 

SP 

32 

20 

2* 

(A 

40 

1* 

96 

60 

SOH    01 

01 

! 

33 

21 

A 

65 

41 

a 

97 

61 

STX     02 

02 

H 

34 

22 

B 

(6 

42 

b 

98 

62 

ETX     03 

03 

0* 

35 

23 

C 

61 

43 

c 

99 

63 

EOT     04 

04 

1* 

36 

24 

D 

68 

AA 

d 

100 

(A 

ENQ    05 

05 

% 

37 

25 

E 

69 

45 

e 

101 

65 

ACK    06 

06 

& 

38 

26 

F 

70 

Ae 

f 

102 

(£ 

BEL     07 

07 

1 

39 

27 

G 

71 

Al 

8 

103 

67 

ASCII  character  sets 
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Table  G-8  (continued) 

ASCII  code  equivalents 

ASCII 

Dec 

Hex   ASCII  Dec 

Hex 

ASCII 

Dec 

Hex 

ASCII 

Dec 

Hex 

BS 

08 

08      ( 

40 

28 

H 

72 

48 

h 

104 

68 

HT 

09 

09     ) 

41 

29 

I 

73 

49 

i 

105 

69 

LF 

10 

OA     • 

42 

2A 

J 

74 

4A 

J 

106 

6A 

VT 

11 

OB     + 

43 

2B 

K 

75 

4 

k 

107 

6B 

FF 

12 

OC     , 

44 

2C 

L 

76 

4C 

1 

108 

6C 

CR 

13 

OD     - 

45 

2D 

M 

77 

4D 

m 

109 

6D 

SO 

14 

OE      . 

46 

2E 

N 

78 

4E 

n 

110 

6E 

SI 

15 

OF      / 

47 

2F 

O 

79 

4F 

o 

111 

6f 

DLE 

16 

10      0 

48 

30 

P 

80 

50 

P 

112 

70 

DCl 

17 

11      1 

49 

31 

Q 

81 

51 

q 

113 

71 

DC2 

18 

12      2 

50 

32 

R 

82 

52 

r 

114 

72 

DC3 

19 

13      3 

51 

33 

S 

83 

53 

s 

115 

73 

DC4 

20 

14      4 

52 

34 

T 

84 

54 

t 

116 

74 

NAK 

21 

15      5 

53 

35 

U 

85 

55 

u 

117 

75 

SYN 

22 

16     6 

54 

36 

V 

86 

56 

V 

118 

76 

ETB 

23 

17      7 

55 

37 

w 

8 

57 

w 

119 

77 

CAN 

24 

18      8 

56 

38 

X 

88 

58 

X 

120 

78 

EM 

25 

19      9 

57 

39 

Y 

89 

59 

y 

121 

79 

SUB 

26 

lA     : 

58 

3A 

z 

90 

5A 

2 

122 

7A 

ESC 

27 

IB      ; 

59 

3B 

3* 

91 

5B 

8* 

123 

7B 

FS 

28 

IC     < 

60 

3C 

4* 

92 

5C 

9* 

124 

7C 

GS 

29 

ID     = 

61 

3D 

5* 

93 

5D 

10* 

125 

7D 

RS 

30 

IE      > 

62 

3E 

6* 

94 

5E 

11* 

126 

7E 

US 

31 

IF      ? 

63 

3F 

95 

5F 

DEL 

127 

7F 

The  following  characters  correspond  to  those  followed  by  an 
asterisk  in  the  preceding  part  of  the  table. 


• 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

10     11 

Hexadecimal 

23 

24 

40 

5B 

5C 

5D 

5E 

60 

7B 

7C 

7D    7E 

English  (USA) 

# 

$ 

@ 

[ 

\ 

] 

A 

- 

{ 

1 

}        - 

English  (UK) 

£ 

$ 

@ 

[ 

\ 

] 

A 

% 

{ 

1 

}        ~ 

German 

# 

$ 

§ 

A 

O 

U 

A 

^ 

a 

o 

ii      & 

French 

£ 

$ 

a 

o 

<? 

§ 

A 

- 

e 

U 

e       • 

Italian 

£ 

$ 

S 

o 

f 

6 

A 

u 

a 

6 

6      i 

Spanish 

£ 

$ 

S 

i 

N 

i 

A 

^ 

0 

n 

e 

382  Appendix  G:  USA  and  International  Models 


Certification 

In  the  countries  where  it  is  applicable,  the  following  product  safety 
certification  supplements  the  USA  FCC  Class  B  notice  printed  on 
the  inside  front  cover  of  this  manual.  The  safety  instructions  apply 
to  all  countries. 


Product  safety 

This  product  is  designed  to  meet  the  requirements  of  safety 
standard  lEC  380,  Safety  of  Electrically  Energized  Office  Machines. 


Important  safety  instructions 

This  equipment  is  intended  to  be  electrically  grounded.  This 
product  is  equipped  with  a  plug  having  a  third  (grounding)  pin.  This 
plug  will  fit  only  into  a  grounding-type  alternating  current  outlet. 
This  is  a  safety  feature. 

If  you  are  unable  to  insert  the  plug  into  the  outlet,  contact  a  licensed 
electrician  to  replace  the  outlet  and,  if  necessary,  install  a 
grounding  conductor. 

Do  not  defeat  the  purpose  of  the  grounding-type  plug. 


Power  supply  specifications 

The  basic  specifications  of  the  power  supply  furnished  with  the 
Apple  lie  for  use  in  Europe  and  other  countries  having  5O-H2 
alternating  current  are  shown  in  Table  G-8. 


Table  6-8 

50-Hz  power  supply  specifications 


Line  voltage  199  to  255  VAC,  50  Hz 

Maximum  Input  25  W 

power  consumption 

Supply  voltage  +15  VDC  (nominal) 

Supply  current  1.2  A  (nominal) 
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Conversion   Tables 


This  briefly  discusses  bits  and  bytes  and  what  they  can  represent, 
and  peripheral  identification  numbers.  It  also  contains  conversion 
tables  for  hexadecimal  to  decimal  and  negative  decimal,  and  a 
number  of  8-bit  codes. 

These  tables  are  intended  for  convenient  reference.  This  appendix 
is  not  intended  as  a  tutorial  for  the  materials  discussed.  The  brief 
section  introductions  are  for  orientation  only. 


Bits  and  bytes 

This  section  discusses  the  relationships  between  bit  values  and  their 
position  within  a  byte.  Here  are  some  rules  of  thumb  regarding  the 
65C02: 

n  A  bit  is  a  binary  digit;  it  can  be  either  a  0  or  a  1. 

n  A  bit  can  be  used  to  represent  any  two-way  choice.  Some  choices 
that  a  bit  can  represent  in  the  Apple  lie  are  listed  in  Table  H-1. 

D  Bits  can  also  be  combined  in  groups  of  any  size  to  represent 
numbers.  Most  of  the  commonly  used  sizes  are  multiples  of  four 
bits. 

n  Four  bits  make  a  nibble  (sometimes  spelled  nybble). 

D  One  nibble  can  represent  any  of  16  values.  Each  of  these  values  is 
assigned  a  number  from  0  through  9  and  (because  our  decimal 
system  has  only  10  of  the  l6  digits  we  need)  A  through  F. 

D  Eight  bits  (two  nibbles)  make  a  byte  (Figure  H-1). 


384 


n  One  byte  can  represent  any  of  l6  x  l6  (or  256)  values.  The  value 
can  be  specified  by  exactly  two  hexadecimal  digits. 

a  Bits  within  a  byte  are  numbered  from  bit  0  on  the  right  to  bit  7  on 
the  left. 

n  The  bit  number  is  the  same  as  the  power  of  2  that  it  represents,  in 
a  manner  completely  analogous  to  the  digits  in  a  decimal 
number. 

a  One  memory  position  in  the  Apple  lie  contains  one  8-bit  byte  of 
data. 

n  How  byte  values  are  interpreted  depends  on  whether  the  byte  is 
an  instruction  in  a  language,  part  or  all  of  an  address,  an  ASCII 
code,  or  some  other  form  of  data.  Tables  H-6  through  H-9  list 
some  of  the  ways  bytes  are  commonly  interpreted. 

n  Two  bytes  make  a  word.  The  16  bits  of  a  word  can  represent  any 
one  of  256  x  256  (or  65,536)  different  values. 

n  The  65C02  uses  a  l6-bit  word  to  represent  memory  locations.  It 
can  therefore  distinguish  among  65,536  (64K)  locations  at  any 
given  time. 

n  A  memory  location  is  one  byte  of  a  256-byte  page.  The  low-order 
byte  of  an  address  specifies  this  byte.  The  high-order  byte 
specifies  the  memory  page  the  byte  is  on. 

Table  H-1 

What  a  bit  can  represent 


Context 

Representing 

0  = 

1  = 

Binary  number 

Place  value 

0 

1  X  that 
power  of  2 

Logic 

Condition 

False 

Tme 

Any  switch 

Position 

Off 

On 

Any  switch 

Position 

Clear* 

Set 

Serial  transfer 

Beginning 

Start 

Carrier  (no 

information 

yet) 

Serial  transfer 

Data 

0  value 

1  value 

Serial  transfer 

Parity 

SPACE 

MARK 

Serial  transfer 

End 

Stop  bit(s) 

Serial  transfer 

Communication 
state 

BREAK 

Carrier 

Bits  and  bytes 
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Table  H-1  (continued) 
What  a  bit  can  represent 


Context 


Representing 


0  = 


P  reg.  bit  N 
P  reg.  bit  V 
P  reg.  bit  B 
P  reg.  bit  D 
P  reg.  bit  I 


P  reg.  bit  Z 
P  reg.  bit  C 
•  Sometimes  ambiguously  termed  reset. 


Neg.  result? 

No 

Yes 

Overflow? 

No 

Yes 

BRK  command? 

No 

Yes 

Decimal  mode? 

No 

Yes 

IRQ  interrupts 

Enabled 

Disabled 
(masked  out) 

Zero  result? 

No 

Yes 

Carry  required? 

No 

Yes 

Figure  H-1 

Bits,  nibbles,  and  bytes 


High  Nibble 


-V" 


Low  Nibble 


MSB 
7 

6 

5 

4 

3 

2 

1 

LSB 
0 

Hexadecimal        $80        $40       $20       $10       $08       $04       $02       $01 
Decimal  128         64        32         16  8  4  2  1 


Table  H-2 

Values  represented  by 

a  nibble 

Binary 

Hex 

Dec 

Binary 

Hex 

Dec 

0000 

$0 

0 

1000 

$8 

8 

0001 

$1 

1 

1001 

$9 

9 

0010 

$2 

2 

1010 

$A 

10 

0011 

$3 

3 

1011 

$B 

11 

0100 

$4 

4 

1100 

$C 

12 

0101 

$5 

5 

1101 

$D 

13 

Olio 

$6 

6 

1110 

$E 

14 

0111 

$7 

7 

nil 

$F 

15 
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Hexadecimal  and  decimal 

Use  Table  H-3  for  conversion  of  hexadecimal  and  decimal 
numbers. 


Table  H-3 

Hexadecimal/decimal  conversior 

1 

Digit 

$xOOO 

$0x00 

$00x0 

$000x 

F 

61440 

3840 

240 

15 

E 

57344 

3584 

224 

14 

D 

53248 

3328 

208 

13 

C 

49152 

3072 

192 

12 

B 

45056 

2816 

176 

11 

A 

40960 

2560 

160 

10 

9 

36864 

2304 

144 

9 

8 

32768 

2048 

128 

8 

7 

28672 

1792 

112 

7 

6 

24576 

1536 

96 

6 

5 

20480 

1280 

80 

5 

4 

16384 

1024 

64 

4 

3 

12288 

768 

48 

3 

2 

8192 

512 

32 

2 

1 

4096 

256 

16 

1 

To  convert  a  hexadecimal  number  to  a  decimal  number,  find  the 
decimal  numbers  corresponding  to  the  positions  of  each 
hexadecimal  digit.  Write  them  down  and  add  them  up. 


For  exam{ 

3le: 

$3C  =  ? 

$FD47  =  ? 

$30  =  48 

$F000  =  61440 

$0C  =  12 

$  DOO  =   3328 
$   40  -     64 

$3C  =  60 

$    7  =      7 

$FD47    =    64839 

To  convert  a  decimal  number  to  hexadecimal,  subtract  from  the 
decimal  number  the  largest  decimal  entry  in  the  table  that  is  less 
than  it.  Write  down  the  hexadecimal  digit  (noting  its  place  value) 
also.  Now  subtract  the  largest  decimal  number  in  the  table  that  is 
less  than  the  decimal  remainder,  and  write  down  the  next 
hexadecimal  digit.  Continue  until  you  have  0  left.  Add  up  the 
hexadecimal  numbers. 
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For  example: 

16215 

=  $  ? 

16215 

-  12288 

=  3927 

12288 

= 

$7000 

3927 

-   3840 

=  87 

3840 

= 

$  FOO 

87 

80 

=  7 

80 

= 

$   50 

7 

7 

= 

$    7 

16215 

= 

$7F57 

Hexadecimal  and  negative  decimal 

If  a  number  is  larger  than  decimal  32,767,  Applesoft  BASIC  allows 
and  Integer  BASIC  requires  you  to  use  the  negative-decimal 
equivalent  of  the  number.  Table  H-4  is  set  up  to  make  it  easy  for  you 
to  convert  a  hexadecimal  number  directly  to  a  negative-decimal 
number. 

Table  H-4 

Hexadecimal  to  negative  decimal  conversion 


Digit 

$xOOO 

$$0x00 

$$00x0 

$$000x 

F 

0 

0 

0 

-1 

E 

^096 

-256 

-16 

-2 

D 

-8192 

-512 

-32 

-3 

C 

-12288 

-768 

-48 

-4 

B 

-16384 

-1024 

-64 

-5 

A 

-20480 

-1280 

-80 

-6 

9 

-24576 

-1536 

-96 

-7 

8 

-28672 

-1792 

-112 

-8 

7 

-2048 

-128 

-9 

6 

-2304 

-144 

-10 

5 

-2560 

-160 

-11 

4 

-2816 

-176 

-12 

3 

-3072 

-192 

-13 

2 

-3328 

-208 

-14 

1 

-3584 

-224 

-15 

0 

-3840 

-240 

-16 
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To  perform  this  conversion,  write  down  the  four  decimal  numbers 
corresponding  to  the  four  hexadecimal  digits  (O's  included).  Then 
add  their  values  (ignoring  their  signs  for  a  moment).  The  resulting 
number,  with  a  minus  sign  in  front  of  it,  is  the  desired  negative- 
decimal  number. 

For  example: 

$C010  =    -  ? 

$C0OO:  -12288 

$  000:  -  3840 

$   10:  -   224 

$   0:  -   16 


$C010      -16368 


To  convert  a  negative-decimal  number  directly  to  a  positive- 
decimal  number,  add  it  to  65,536.  (This  addition  ends  up  looking 
like  subtraction.) 

For  example: 

-151    =   +    ? 

65536  +  (-151)  =  65536  -  151  =  65385 

To  convert  a  negative-decimal  number  to  a  hexadecimal  number, 
first  convert  it  to  a  positive-decimal  number,  then  use  Table  H-3. 


Peripheral  identification  numbers 

Many  Apple  products  now  use  peripheral  identification  numbers 
(called  PIN  numbers)  as  shorthand  to  designate  serial  device 
characteristics.  The  Apple  II  series  Universal  Utilities  disk  presents  a 
menu  from  which  to  select  the  characteristics  of,  say,  a  printer  or 
modem.  From  the  selections  made,  it  generates  a  PIN  for  the  user. 
Other  products  have  a  ready-made  PIN  that  the  user  can  simply  type 
in. 

Table  H-5  is  a  definition  of  the  PIN  number  digits.  When 
communication  mode  is  selected,  the  seventh  digit  is  ignored. 

For  example: 

252/1111  means: 

Communication  mode.  Do  not  echo  output  to  display. 

8  data  bits,  1  stop  bit.  No  line  feed  after  carriage  return. 

300  baud  (bits  per  second).  Do  not  generate  carriage  returns. 
No  parity. 
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Table  H-5 

PIN  numbers 


1  =  Printer  mode 

2  =  Communication  mode* 

1  =  6  data  bits,  1  stop  bit 

2  =  6  data  bits,  2  stop  bits 

3  =  7  data  bits,  1  stop  bit 

4  =  7  data  bits,  2  stop  bits 

5  =  8  data  bits,  1  stop  bit 

6  =  8  data  bits,  2  stop  bits 

1  =  110  bits  per  second 

2  =  300  bits  per  second 

3  =  1200  bits  per  second 

4  =  2400  bits  per  second 

5  =  4800  bits  per  second 

6  =  9600  bits  per  second 

7  =  19200  bits  per  second 

1  =  No  parity 

2  =  Even  parity  (total  on  =  even) 

3  =  Odd  parity  (total  on  =  odd) 

4  =  JVIARK  parity  (parity  bit  =  1) 

5  =  SPACE  parity  (parity  bit  =  ^' 


0)     I 


1  =  Do  not  echo  output  on  screen 

2  =  Echo  output  on  screen  

1  =  Do  not  generate  LF  after  CR 

2  =  Generate  LF  after  CR  _ 

1  =  Do  not  generate  CR* 

2  =  Generate  CR  after  40  characters 

3  =  Generate  CR  after  72  characters 

4  =  Generate  CR  after  80  characters 

5  =  Generate  CR  after  132  characters. 

•  If  you  select  communication  mode,  then  seventh  digit  must  equal  1.  This  value  is  supplied  automatically  when 
you  use  the  UUD. 
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Eight-bit  code  conversions 

Tables  H-6  through  H-9  show  the  entire  ASCII  character  set.  Note 
that  character  values  are  shown  with  the  high  bit  off.  Unless 
otherwise  noted,  all  ASCII  character  values  above  $7F  (127  decimal) 
generate  the  same  character  as  that  value  with  the  high  bit  off.  Here 
is  how  to  interpret  these  tables: 

D  The  Binary  column  has  the  8-bit  code  for  each  ASCII  character. 

n  The  first  128  ASCII  entries  represent  7-bit  ASCII  codes  plus  a 
high-order  bit  of  0  (SPACE  parity  or  Pascal) — for  example, 
01001000  for  the  letter  H. 

n  The  last  128  ASCII  entries  (from  128  through  255)  represent  7-bit 
ASCII  codes  plus  a  high-order  bit  of  1  (MARK  parity  or 
BASIC)— for  example,  11001000  for  the  letter  H. 

a  A  transmitted  or  received  ASCII  character  will  take  whichever 
form  (in  the  communication  register)  is  appropriate  if  odd  or 
even  parity  is  selected — for  example,  11001000  for  an  odd-parity 
H,  01001000  for  an  even-parity  H. 

D  The  ASCII  Char  column  gives  the  ASCII  character  name. 

n  The  Interpretation  column  spells  out  the  meaning  of  special 
symbols  and  abbreviations,  where  necessary. 

D  The  What  to  type  column  indicates  what  keystrokes  generate  the 
ASCII  character  (where  it  is  not  obvious). 

n  The  columns  marked  Pri  and  Alt  indicate  what  displayed 
character  results  from  each  code  when  using  the  primary  or 
alternate  display  character  set,  respectively.  Boldface  is  used  for 
inverse  characters;  italic  is  used  for  flashing  characters. 

Note  that  the  values  $40  through  $5F  (and  $C0  through  $DF)  in 
the  alternate  character  set  are  displayed  as  MouseText  characters 
(Figure  5-1)  if  the  firmware  is  set  to  do  so,  or  if  the  firmware  is 
bypassed. 

♦  Note:  The  primary  and  alternate  displayed  character  sets  in 
Tables  H-6  through  H-9  are  the  result  of  firmware  mapping. 
The  character  generator  ROM  actually  contains  only  one 
character  set.  The  firmware  mapping  procedure  is  described  in 
Chapter  3. 
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Table  H-6 

Control  characters,  high  bit  off 


ASCII 

Binary 

Dec 

Hex 

char 

Interpretallon 

What  to  type 

Pri 

Alt 

0000000 

0 

$00 

NUL 

Blank  (null) 

Control-® 

@ 

® 

0000001 

1 

$01 

SOH 

Start  of  header 

Control-A 

A 

A 

0000010 

2 

$02 

STX 

Start  of  text 

Control-B 

B 

B 

0000011 

3 

$03 

ETX 

End  of  text 

Control-C 

C 

C 

0000100 

4 

$04 

EOT 

End  of  transm. 

Control-D 

D 

D 

0000101 

5 

$05 

ENQ 

Enquiry 

Control-E 

E 

E 

0000110 

6 

$06 

ACK 

Acknowledge 

Control-F 

F 

F 

0000111 

7 

$07 

BEL 

Bell 

Control-G 

G 

G 

0001000 

8 

$08 

BS 

Backspace 

Control-H  oi 

•  Left  Arrow-H 

H 

H 

0001001 

9 

$09 

HT 

Horizontal  tab 

Control-I  or 

Tab 

I 

I 

0001010 

10 

$0A 

LF 

Line  feed 

Control-J  or 

Down  Arrow-J 

J 

J 

0001011 

11 

$0B 

VT 

Vertical  tab 

Control-K  or 

Up  Arrow 

K 

K 

0001100 

12 

$0C 

FF 

Form  feed 

Control-L 

L 

L 

0001101 

13 

$0D 

CR 

Carriage  return 

Control-M  or  Return 

M 

M 

0001110 

14 

$0E 

SO 

Shift  out 

Control-N 

N 

N 

0001111 

15 

$0F 

SI 

Shift  in 

Control-O 

O 

O 

0010000 

16 

$10 

DLE 

Data  link  escape 

Control-P 

P 

P 

0010001 

17 

$11 

DCl 

Device  control  1 

Control-Q 

Q 

Q 

0010010 

18 

$12 

DC2 

Device  control  2 

Control-R 

R 

R 

0010011 

19 

$13 

DC3 

Device  control  3 

Control-S 

S 

S 

0010100 

20 

$14 

DC4 

Device  control  4 

Control-T 

T 

T 

0010101 

21 

$15 

NAK 

Neg.  acknowledge 

Control-U  or 

Right  Arrow 

U 

U 

0010110 

22 

$16 

SYN 

Synchronization 

Control-V 

V 

V 

0010111 

23 

$17 

ETB 

End  of  text  blk. 

Control-W 

W 

w 

0011000 

24 

$18 

CAN 

Cancel 

Control-X 

X 

X 

0011001 

25 

$19 

EM 

End  of  medium 

Control-Y 

Y 

Y 

0011010 

26 

$1A 

SUB 

Substitute 

Control-Z 

2 

2 

0011011 

27 

$1B 

ESC 

Escape 

Control-!  or 

Escape 

[ 

[ 

0011100 

28 

$1C 

FS 

File  separator 

Control-\ 

\ 

\ 

0011101 

29 

$1D 

GS 

Group  separator 

Control-] 

] 

] 

0011110 

30 

$1E 

RS 

Record  separator 

Control-A 

A 

A 

0011111 

31 

$1F 

US 

Unit  separator 

Control-. 
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Table  H-7 

Special  characters,  high  bit  off 


Dec       Hex 


ASCII 
char 


Interpretation 


What  to  type 


Pri       Alt 


32 

$20 

SP 

Space 

33 

$21 

! 

34 

$22 

» 

35 

$23 

# 

36 

$24 

$ 

37 

$25 

% 

38 

$26 

& 

39 

$27 

1 

Apostrophe 

40 

$28 

C 

41 

$29 

) 

42 

$2A 

* 

43 

$2B 

+ 

44 

$2C 

) 

Comma 

45 

$2D 

- 

Hyphen 

46 

$2E 

. 

Period 

47 

$2F 

/ 

48 

$30 

0 

49 

$31 

1 

50 

$32 

2 

51 

$33 

3 

52 

$34 

4 

53 

$35 

5 

54 

$36 

6 

55 

$37 

7 

56 

$38 

8 

57 

$39 

9 

58 

$3A 

59 

$3B 

) 

60 

$3C 

< 

61 

$3D 

= 

62 

$3E 

> 

63 

$3F 

? 

Space  bar 


# 

# 

$ 

$ 

% 

% 

& 

1 

& 

1 

( 

( 

) 

) 

/ 

/ 

0 

0 

1 

1 

2 

2 

3 

3 

4 

4 

5 

5 

6 

6 

7 

7 

8 

8 

9 

9 

> 

9 


> 
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Table  H-8 

Uppercase  characters,  high  bit  off 


Binary 


Dec       Hex 


ASCil 
char 


Interpretation 


Wtiat  to  type 


1000000 

64 

$40 

@ 

1000001 

65 

$41 

A 

1000010 

66 

$42 

B 

1000011 

67 

$43 

C 

1000100 

68 

$44 

D 

1000101 

69 

$45 

E 

1000110 

70 

$46 

F 

1000111 

71 

$47 

G 

1001000 

72 

$48 

H 

1001001 

73 

$49 

I 

1001010 

74 

$4A 

J 

1001011 

75 

$4B 

K 

1001100 

76 

$4C 

L 

1001101 

77 

$4D 

M 

1001110 

78 

$4E 

N 

1001111 

79 

$4F 

O 

1010000 

80 

$50 

P 

1010001 

81 

$51 

Q 

1010010 

82 

$52 

R 

1010011 

83 

$53 

S 

1010100 

84 

$54 

T 

1010101 

85 

$55 

U 

1010110 

86 

$56 

V 

1010111 

87 

$57 

W 

1011000 

88 

$58 

X 

1011001 

89 

$59 

Y 

1011010 

90 

$5A 

Z 

1011011 

91 

$5B 

[ 

1011100 

92 

$5C 

\ 

1011101 

93 

$5D 

] 

1011110 

94 

$5E 

A 

1011111 

95 

$5F 

Pri       Ait 


A 

c5 

B 

k 

C 

X 

D 

^ 

E 

s 

F 

Bl 

G 

^z 

H 

<^ 

I 

... 

J 

^ 

K 

t 

L 

M 

♦J 

N 

■ 

O 

> 

P 

V 

Q 

■^ 

R 

¥. 

S 

— 

T 

L 

U 

^ 

V 

m 

W 

m 

X 

c 

Y 

Zl 

Z 

1 

Opening  bracket 

f 

♦ 

Reverse  slant 

\ 

_ 

Closing  bracket 

J 

Caret 

A 

II 

Underline 

1 

•  If  the  higli  bit  is  set,  tiie  MouseText  ciiaracters  are  replaced  with  their  equivalent  in  the  primary  character  set 
with  that  value. 
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Table  H-9 

Lowercase  characters,  high  bit  off 


Dec       Hex 


ASCII 
char 


interpretation 


What  to  type 


PrI 

Alt 

» 

/ 

a 

» 

b 

# 

c 

$ 

d 

% 

e 

& 

f 

J 

g 

( 

h 

) 

i 

* 

i 

+ 

k 

t 

1 

- 

m 

n 

/ 

o 

0 

P 

1 

q 

2 

r 

3 

s 

4 

t 

5 

u 

6 

V 

7 

w 

8 

X 

9 

y 

z 

96 

$60 

V 

Grave  accent 

97 

$61 

a 

98 

$62 

b 

99 

$63 

c 

100 

%6A 

d 

101 

$65 

e 

102 

%66 

f 

103 

$67 

S 

104 

$68 

h 

105 

$69 

i 

106 

$6A 

J 

107 

$6B 

k 

108 

$6C 

1 

109 

$6D 

m 

110 

$6e 

n 

111 

$6f 

o 

112 

$70 

P 

113 

$71 

q 

114 

$72 

r 

115 

$73 

s 

116 

$74 

t 

117 

$75 

u 

118 

$76 

V 

119 

$77 

w 

120 

$78 

X 

121 

$79 

y 

122 

$7A 

z 

123 

$7B 

{ 

Opening  brace 

124 

$7C 

1 

Vertical  line 

125 

$7D 

} 

Closing  brace 

126 

$7E 

~ 

Overline  (tilde) 

127 

$7F 

DEL 

Delete/rubout 

> 

? 


DEL 
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Firmware  Listings 


Appendix  I  is  a  listing  of  the  source  code  for  the  Monitor  firmware 
(including  the  Smartport)  contained  in  the  memory  expansion 
version  of  the  Apple  lie. 

If  you  are  developing  products  for  an  earlier  version  of  the  lie,  you 
can  obtain  a  complete  set  of  firmware  listings  from  the  Apple 
Programmer's  and  Developer's  Association  (APDA).  You  can  also 
order  additional  technical  information  on  other  Apple  products 
from  the  APDA.  To  obtain  the  listing  set  or  other  technical 
information,  write  to 

Apple  Programmer's  and  Developer's  Association 
290  SW  43d  Street 
Renton,  WA  98055 
206-251-6548 


396 


Table  1-1 

Main  side  ROM  map 

ClOO 

serial  port 

C200 

communications  port 

C300 

80-column  routines 

C400 

memory  expansion  card:  boot  code/entry  point 
for  ProDOS/entry  point  for  DOS 

C500-C58D 

UniDisk  3.5  routines 

C58E 

miscellaneous 

C600 

Disk  II  routines 

C700-Cy/F 

Mouse  entry  points 

C780 

ROM  switch  routines 

C7FC 

last  screen  hole 

CBOO 

Interrupt  routines 

C900 

Paddle  patch;  Mini-Assembler 

CAOO 

Mini-Assembler;  step  and  trace 

CBOO 

scroll  routines 

CCOO 

pasinvert;  picky;  showcur;  update;  escape 

CDOO 

video  routines 

CEOO 

video  routines 

CFOO 

video  routines;  miscellaneous 

D000-F7FF 

Applesoft  BASIC 

F800-bVbV 

RESET  vectors 

Appendix  i:  Firmware  Listings 
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Table  1-2 

Auxiliary  side 


ROM  map 
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ClOO 

C200 

C300 

C400 

C500-C57F 

C780 

C800-C87F 

C880-CFFF 

DOOO 

DlOO 

D200-D249 

D24A-D3FF 

D400 

D4A9-D52B 

D500-D52B 

D52C-D5FF 

D600-D700 

D800 

D900 
DAOO 

DBOO 
DCOO 

DCFO-DCFF 
DDOO 

DEOO 

DFOO 

E000-FFF9 
Appendix  1:  Firmware  Listings 


Mouse  interrupt  handler;  ACIA  interrupt  handler 

continue;  ACIA  routines 

ACIA  routines;  moveaux;  xfer;  memory  test 

continue;  switch  test 

diagnostics 

ROM  switch  routines 

miscellaneous 

UniDisk  3.5  routines 

command  processor  for  serial  and 
communications  ports 

continue 

Mouse  BASIC  routines 

empty 

basilin;  hex-to-dec 

zero  page  test 

miscellaneous 

empty 

Mouse  routines 

execute;  xdiag;  xstatus;  pstatO;  pcn4l;  pstatus; 
xread;  xwrite;  prdblk;  pwrblk;  pread 

pread  continue;  pwrite 

dospatch;  dosconv;  stattbl;  parmtbl;  undtbl; 
testsize;  format 

fmpas;  fmdos;  makecat;  cattbl;  procut 

doscut;  pascut 

diagnostics  (orged  at  $DDOO) 

stattest;  addresstest;  rollovertest;  addbustest; 
cleartest;  fuUtest 

continue;  computed;  pass;  fail;  miscellaneous 

print;  messages 

empty 


O  m 


I? 


I 


&*        n 


o  > 

^    <D    (L> 
*J  ■— I    W 

O  i<  •— I 
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i-S     : 


3 

tS 

i; 

; 

12 
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■s 
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s, 
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,.  iTS 
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■" 
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O    CU 


■<  c«j  n  "ir  iri  V 


1  ca  C3  C3  ^  £3  c 
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>  es  o  ca  ^  C3  c 


>  CI  ^  o  o  c 
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accumulator:  The  register  in  the  65C02 
microprocessor  where  most  computations  are 
performed. 

ACIA:  Acronym  for  Asynchronous 
Communications  Interface  Adapter.  A  single  chip 
that  converts  data  from  parallel  to  serial  form  and 
vice  versa.  An  ACIA  handles  serial  transmission 
and  reception  and  RS-232-C  signals  under  the 
control  of  its  internal  registers,  which  can  be  set 
and  changed  by  firmware  or  software. 

acronym:  A  word  formed  from  the  initial  letters 
of  a  name  or  phrase,  such  as  ROM  (from  read- 
only memory). 

ADC:  See  analog-to-dlgltal  converter. 

address:  A  number  that  specifies  the  location  of  a 
single  byte  of  memory.  Addresses  can  be  given  as 
decimal  integers  or  as  hexadecimal  integers.  A 
64K  system  has  addresses  ranging  from  0  to  65535 
(in  decimal)  or  from  $0000  to  $FFFF  (in 
hexadecimal). 

algorithm:  A  step-by-step  procedure  for  solving 
a  problem  or  accomplishing  a  task. 

American  Simplified  Keyboard:  See  Dvorak 
keyboard. 

analog:  Varying  smoothly  and  continuously  over 
a  range,  rather  than  changing  in  discrete  jumps. 
For  example,  a  conventional  12-hour  clock  face  is 
an  analog  device  that  shows  the  time  of  day  by  the 
continuously  changing  position  of  the  clock's 
hands.  Compare  digital. 


analog  data:  Data  in  the  form  of  continuously 
variable  quantities.  Compare  digital  data. 

analog  signal:  A  signal  that  varies  continuously 
over  time,  rather  than  being  sent  and  received  in 
discrete  intervals.  Compare  digital  signal. 

analog-to-digital  converter  (ADC):  A  device 
that  converts  quantities  from  analog  to  digital 
form.  For  example,  computer  hand  controls 
convert  the  position  of  the  control  dial  (an  analog 
quantity)  into  a  discrete  number  (a  digital 
quantity)  that  changes  stepwise  even  when  the  dial 
is  turned  smoothly. 

AND:  A  logical  operator  that  produces  a  true  result 
if  both  its  operands  are  true,  and  a  false  result  if 
either  or  both  its  operands  are  false.  Compare 
OR,  NOT,  exclusive  OR. 

ANSI:  Acronym  for  American  National 
Standards  Institute,  which  sets  standards  for  many 
technical  fields  and  is  the  most  common  standard 
for  computer  terminals. 

Apple  I:  The  first  Apple  computer.  It  was  built  in  a 
garage  in  California  by  Steve  Jobs  and  Steve 
Wozniak. 

Applesoft  BASIC:  The  Apple  II  dialect  of  the 
BASIC  programming  language.  An  interpreter  for 
creating  and  executing  Applesoft  BASIC  programs 
is  built  into  the  firmware  of  computers  in  the 
Apple  II  family.  See  also  BASIC,  Integer 
BASIC. 
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Apple  ni:  An  Apple  computer;  part  of  the 
Apple  II  family.  The  Apple  III  offered  a  built-in 
disk  drive  and  built-in  RS-232-C  (serial)  port.  Its 
memory  was  expandable  to  256K. 

Apple  n:  A  family  of  computers,  including  the 
original  Apple  II,  the  Apple  II  Plus,  the  Apple  He, 
the  Apple  lie,  and  the  Apple  IIGS.  The  original 
Apple  II  used  Integer  BASIC  instead  of  Applesoft 
BASIC,  and  it  required  a  keyboard  command 
CPR#6)  in  order  to  start  up  from  a  disk. 

Apple  nc:  A  transportable  personal  computer  in 
the  Apple  II  family,  with  a  disk  drive  and  80- 
column  display  capability  built  in. 

Apple  He:  A  personal  computer  in  the  Apple  II 
family  with  seven  expansion  slots  and  an  auxiliary 
memory  slot  that  allow  the  user  to  enhance  the 
computer's  capabilities  with  peripheral  and 
auxiliary  cards.  The  Apple  He  has  been  improved 
and  enhanced  over  the  years. 

Apple  ne  80-Colunin  Text  Card:  A  peripheral 
card  that  plugs  into  the  Apple  He's  auxiliary 
memory  slot  and  allows  the  computer  to  display 
either  40  or  80  characters  per  line. 

Apple  He  Extended  80-Column  Text  Card: 

A  peripheral  card  that  plugs  into  the  Apple  He's 
auxiliary  memory  slot  and  allows  the  computer  to 
display  either  40  or  80  characters  per  line  while 
extending  the  computer's  memory  capacity  by 
64K. 

Apple  IIGS:  A  powerful  new  member  of  the 
Apple  II  family.  The  Apple  IIGS  uses  a  l6-bit 
microprocessor  and  has  256K  of  RAM.  It  has  slots 
like  the  Apple  He  and  ports  like  the  Apple  lie,  and 
contains  a  15-voice  custom  sound  chip. 

Apple  n  Pascal:  A  software  system  for  the 
Apple  II  family  that  lets  you  create  and  execute 
programs  written  in  the  Pascal  programming 
language.  Apple  II  Pascal  was  adapted  by  Apple 
Computer  from  the  University  of  California,  San 
Diego,  Pascal  Operating  System  (UCSD  Pascal). 


Apple  n  Plus:  A  personal  computer  in  the 
Apple  II  family  with  expansion  slots  that  allow  the 
user  to  enhance  the  computer's  capabilities  with 
peripheral  and  auxiliary  cards. 

application  program:  A  program  written  for 
some  specific  purpose,  such  as  word  processing, 
data  base  management,  graphics,  or 
telecommunication.  Compare  system 
program. 

argument:  A  value  on  which  a  function  or 
statement  operates;  it  can  be  a  number  or  a 
variable.  For  example,  in  the  BASIC  statement 
VTAB   10,  the  number  10  is  the  argument. 
Compare  operand. 

arithmetic  expression:  A  combination  of 
numbers  and  arithmetic  operators  (such  as  3  +  5) 
that  indicates  some  operation  to  be  carried  out. 

arithmetic  operator:  An  operator,  such  as  +, 
that  combines  numeric  values  to  produce  a 
numeric  result.  Compare  logical  operator, 
relational  operator. 

ASCII:  Acronym  for  American  Standard  Code 
for  Information  Interchange;  pronounced  "ASK- 
ee."  A  code  in  which  the  numbers  from  0  to  127 
stand  for  text  characters.  ASCII  code  is  used  for 
representing  text  inside  a  computer  and  for 
transmitting  text  between  computers  or  between  a 
computer  and  a  peripheral  device.  Compare 
EBCDIC. 

assembler:  A  language  translator  that  converts  a 
program  written  in  assembly  language  into  an 
equivalent  program  in  machine  language.  The 
opposite  of  a  disassembler. 

assembly  language:  A  low-level  programming 
language  in  which  individual  machine-language 
instructions  are  written  in  a  symbolic  form  that's 
easier  to  understand  than  machine  language  itself. 
Each  assembly-language  instruction  produces  one 
machine-language  instruction.  See  also  machine 
language. 
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asynchronous:  Not  synchronized  by  a  mutual 
timing  signal  or  clock.  Compare  synchronous. 

asynchronous  transmission:  A  method  of  data 
transmission  in  which  the  receiving  and  sending 
devices  don't  share  a  common  timer,  and  no 
timing  data  is  transmitted.  Each  information 
character  is  individually  synchronized,  usually  by 
the  use  of  start  and  stop  bits.  The  time  interval 
between  characters  isn't  necessarily  fixed. 
Compare  synchronous  transmission. 

auxiliary  slot:  The  special  expansion  slot  inside 
the  Apple  He  used  for  the  Apple  He  80-Column 
Text  Card  or  Extended  80-Column  Text  Card,  and 
also  for  the  RGB  monitor  card.  The  slot  is 
labeled  AUX.  CONNECTOR  on  the  circuit  board. 

back  panel:  The  rear  surface  of  the  computer, 
which  includes  the  power  switch,  the  power 
connector,  and  connectors  for  peripheral 
devices. 

band^dth:  The  range  of  frequencies  a  device  can 
handle.  Bandwidth  and  maximum  data  transfer 
rate  are  directly  proportional.  For  example,  a 
video  monitor's  greater  bandwidth  allows  it  to 
display  more  information  per  scan  frame  than 
most  home  television  sets  can.  To  display  80 
columns  of  text,  a  monitor  should  have  a 
bandwidth  of  at  least  12  MHz. 

base  address:  In  indexed  addressing,  the  fixed 
component  of  an  address. 

BASIC:  Acronym  for  Beginners  All-purpose 
Symbolic  Instruction  Code.  BASIC  is  a  high-level 
programming  language  designed  to  be  easy  to 
learn.  Two  versions  of  BASIC  are  available  from 
Apple  Computer  for  use  with  all  Apple  Il-family 
systems:  Applesoft  BASIC  Obuilt  into  the  firmware) 
and  Integer  BASIC. 

baud:  A  unit  of  data  transmission  speed:  the 
number  of  discrete  signal  state  changes  per 
second.  Often,  but  not  always,  equivalent  to  bits 
per  second.  Compare  bit  rate. 


binary:  Characterized  by  having  two  different 
components,  or  by  having  only  two  alternatives  or 
values  available;  sometimes  used  synonymously 
with  binary  system. 

binary  digit:  The  smallest  unit  of  information  in 
the  binary  number  system;  a  0  or  a  1.  Also  called  a 
bit 

binary  operator:  An  operator  that  combines  two 
operands  to  produce  a  result.  For  example,  +  is  a 
binary  arithmetic  operator;  <  is  a  binary 
relational  operator;  OR  is  a  binary  logical 
operator.  Compare  unary  operator, 

binary  system:  The  representation  of  numbers 
in  the  base-2  system,  using  only  the  two  digits  0 
and  1.  For  example,  the  numbers  0,  1,2,  3,  and  4 
become  0,  1,  10,  11,  and  100  in  binary  notation. 
The  binary  system  is  commonly  used  in  computers 
because  the  values  0  and  1  can  easily  be 
represented  in  a  variety  of  ways,  such  as  the 
presence  or  absence  of  current,  positive  or 
negative  voltage,  or  a  white  or  black  dot  on  the 
display  screen.  A  single  binary  digit — a  0  or  a  1— is 
called  a  bit  Compare  decimal,  hexadecimal. 

bit:  A  contraction  of  binary  digit  The  smallest 
unit  of  information  that  a  computer  can  hold.  The 
value  of  a  bit  (1  or  0)  represents  a  simple  two-way 
choice,  such  as  yes  or  no,  on  or  off,  positive  or 
negative,  something  or  nothing.  See  also  binary 
system. 

bit  rate:  The  speed  at  which  bits  are  transmitted, 
usually  expressed  as  bits  per  second,  or  bps. 
Compare  baud. 

bits  per  second:  See  bit  rate. 

board:  See  printed-circuit  board. 

body:  In  BASIC,  the  statements  or  instructions 
that  make  up  a  part  of  a  program,  such  as  a  loop  or 
a  subroutine. 
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boot:  Another  way  to  say  start  up.  A  computer 
boots  by  loading  a  program  into  memory  from  an 
external  storage  medium  such  as  a  disk.  Starting  up 
is  often  accomplished  by  first  loading  a  small 
program,  which  then  reads  a  larger  program  into 
memory.  The  program  is  said  to  "pull  itself  up  by 
its  own  bootstraps" — hence  the  term 
bootstrapping  or  booting. 

boot  disk:  See  startup  disk. 

bootstrap:  See  boot. 

bps:  See  bit  rate. 

branch:  (v)  To  pass  program  control  to  a  line  or 
statement  other  than  the  next  in  sequence,  (n)  A 
statement  that  performs  a  branch.  See 
conditional  branch,  unconditional  branch. 

BREAK:  A  SPACE  (0)  signal,  sent  over  a 
communication  line,  of  long  enough  duration  to 
interrupt  the  sender.  This  signal  is  often  used  to 
end  a  session  with  a  time-sharing  service.  BREAK 
is  also  used  in  BASIC  to  stop  execution  of  a 
program;  it's  generated  by  pressing  Control-C. 

BRK:  A  "software  interrupt."  An  instruction  that 
causes  the  6502  or  65C02  microprocessor  to  halt. 
Pronounced  "break." 

buffer:  A  "holding  area"  of  the  computer's 
memory  where  information  can  be  stored  by  one 
program  or  device  and  then  read  at  a  different  rate 
by  another;  for  example,  a  print  buffer.  In  editing 
functions,  an  area  in  memory  where  deleted  (cut) 
or  copied  data  is  held.  In  some  applications,  this 
area  is  called  the  Clipboard. 

bug:  An  error  in  a  program  that  causes  it  not  to 
work  as  intended.  The  expression  reportedly 
comes  from  the  early  days  of  computing  when  an 
itinerant  moth  shorted  a  connection  and  caused  a 
breakdown  in  a  room-size  computer. 


bus:  A  group  of  wires  or  circuits  that  transmit 
related  information  from  one  part  of  a  computer 
system  to  another.  In  a  network,  a  line  of  cable 
with  connectors  linking  devices  together.  A  bus 
network  has  a  beginning  and  an  end.  0t's  not  in  a 
closed  circle  or  T  shape.) 

byte:  A  unit  of  information  consisting  of  a  fixed 
number  of  bits.  On  Apple  II  systems,  one  byte 
consists  of  a  series  of  eight  bits,  and  a  byte  can 
represent  any  value  between  0  and  255.  The 
sequence  represents  an  instruction,  letter, 
number,  punctuation  mark,  or  other  character. 
See  also  kilobyte,  megabyte. 

cable:  An  insulated  bundle  of  wires  with 
connectors  on  the  ends;  the  number  of  wires 
varies  with  the  type  of  connection.  Examples  are 
serial  cables,  disk  drive  cables,  and  AppleTalk 
cables. 

call:  (v)  To  request  the  execution  of  a  subroutine, 
function,  or  procedure,  (n)  A  request  from  the 
keyboard  or  from  a  procedure  to  execute  a  named 
procedure.  See  procedure. 

carriage  return:  An  ASCII  character  (decimal  13) 
that  ordinarily  causes  a  printer  or  display  device  to 
place  the  next  character  on  the  left  margin. 

carrier:  The  background  signal  on  a 
communication  channel  that  is  modified  to  carry 
information.  Under  RS-232-C  rules,  the  carrier 
signal  is  equivalent  to  a  continuous  MARK  (1) 
signal;  a  transition  to  0  then  represents  a  start  bit. 

carry  flag:  A  status  bit  in  the  6502  or  65C02 
microprocessor,  used  as  a  ninth  bit  with  the  eight 
accumulator  bits  in  addition,  subtraction, 
rotation,  and  shift  operations. 

cathode-ray  tube  (CRT):  An  electronic  device, 
such  as  a  television  picture  tube,  that  produces 
images  on  a  phosphor-coated  screen.  The 
phosphor  coating  emits  light  when  struck  by  a 
focused  beam  of  electrons.  A  common  display 
device  used  with  personal  computers. 
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central  processing  unit  (CPU):  The  "brain"  of 
the  computer;  the  microprocessor  that  performs 
the  actual  computations  in  machine  language.  See 
microprocessor. 

character:  Any  symbol  that  has  a  widely 
understood  meaning  and  thus  can  convey 
information.  Some  characters — such  as  letters, 
numbers,  and  punctuation — can  be  displayed  on 
the  monitor  screen  and  printed  on  a  printer. 
Compare  control  character. 

character  code:  A  number  used  to  represent  a 
character  for  processing  by  a  computer  system. 

character  set:  The  entire  set  of  characters  that 
can  be  either  shown  on  a  monitor  or  used  to  code 
computer  instructions.  In  a  printer,  the  entire  set 
of  characters  that  the  printer  is  capable  of 
printing. 

chip:  See  integrated  circuit. 

Clear  To  Send:  An  RS-232-C  signal  from  a  DCE  to 
a  DTE  that  is  normally  kept  false  until  the  DCE 
makes  it  true,  indicating  that  all  circuits  are  ready 
to  transfer  data  out.  See  Data  Communication 
Equipment,  Data  Terminal  Equipment. 

code:  CD  A  number  or  symbol  used  to  represent 
some  piece  of  information.  (2)  The  statements  or 
instructions  that  make  up  a  program. 

cold  start:  The  process  of  starting  up  the  Apple  II 
when  the  power  is  first  turned  on  (or  as  if  the  power 
had  just  been  turned  on)  by  loading  the  operating 
system  into  main  memory,  and  then  loading  and 
running  a  program.  Compare  warm  start. 

column:  A  vertical  arrangement  of  graphics 
points  or  character  positions  on  the  display. 

command:  An  instruction  that  causes  the 
computer  to  perform  some  action.  A  command 
can  be  typed  from  a  keyboard,  selected  from  a 
menu  with  a  hand-held  device  (such  as  a  mouse), 
or  embedded  in  a  program. 


command  character:  An  ASCII  character, 
usually  Control-A  or  Control-I,  that  causes  the 
serial  port  firmware  to  interpret  subsequent 
characters  as  commands. 

command  register:  An  ACIA  location  (at  $C09A 
for  port  1  and  $COAA  for  port  2)  that  stores  parity 
type  and  RS-232-C  signal  characteristics. 

compiler:  A  language  translator  that  converts  a 
program  written  in  a  high-level  programming 
language  (source  code)  into  an  equivalent 
program  in  some  lower-level  language  such  as 
machine  language  (object  code)  for  later 
execution.  Compare  interpreter. 

composite  video:  A  video  signal  that  includes 
both  display  information  and  the  synchronization 
(and  other)  signals  needed  to  display  it.  See  RGB 
monitor. 

computer:  An  electronic  device  that  performs 
predefined  (programmed)  computations  at  high 
speed  and  with  great  accuracy.  A  machine  that  is 
used  to  store,  transfer,  and  transform 
information. 


computer  language: 
language. 


See  programming 


computer  system:  A  computer  and  its 
associated  hardware,  firmware,  and  software. 

conditional  branch:  A  branch  whose  execution 
depends  on  the  truth  of  a  condition  or  the  value  of 
an  expression.  Compare  unconditional  branch. 

configiuratlon:  (1)  The  total  combination  of 
hardware  components — CPU,  video  display 
device,  keyboard,  and  peripheral  devices — that 
make  up  a  computer  system.  (2)  The  software 
settings  that  allow  various  hardware  components 
of  a  computer  system  to  communicate  with  each 
other. 

connector:  A  plug,  socket,  jack,  or  port. 

constant:  In  a  program,  a  symbol  that  represents 
a  fixed,  unchanging  value.  Compare  variable. 
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control  character:  A  nonprinting  character  that 
controls  or  modifies  the  way  information  is 
printed  or  displayed.  In  the  Apple  II  family, 
control  characters  have  ASCII  values  between  0 
and  31,  and  are  typed  from  a  keyboard  by  holding 
down  the  Control  key  while  pressing  some  other 
key.  In  the  Macintosh  family,  the  Command  key 
performs  a  similar  function. 

control  code:  One  or  more  nonprinting 
characters — ^included  in  a  text  file — ^whose 
function  is  to  change  the  way  a  printer  prints  the 
text.  For  example,  a  program  may  use  certain 
control  codes  to  turn  boldface  printing  on  and  off. 
See  control  character. 

control  key:  A  general  term  for  a  key  that  controls 
the  operation  of  other  keys;  for  example,  Apple, 
Caps  Lock,  Control,  Option,  and  Shift.  When  you 
hold  down  or  engage  a  control  key  while  pressing 
another  key,  the  combination  makes  that  other  key 
behave  differently.  Also  called  a  modifier  key. 

Control  key:  A  specific  key  on  Apple  Il-family 
keyboards  that  produces  control  characters 

when  used  in  combination  with  other  keys. 

controller  card:  A  peripheral  card  that  connects 
a  device  such  as  a  printer  or  disk  drive  to  a 
computer's  main  logic  board  and  controls  the 
operation  of  the  device. 

control  register:  An  ACIA  location  (  at  $C09B 
for  port  1  and  $COAB  for  port  2)  that  stores  data 
format  and  baud  rate  selections. 

Control-Reset:  A  combination  keystroke  on 
Apple  Il-family  computers  that  usually  causes  an 
Applesoft  BASIC  program  or  command  to  stop 
immediately.  If  a  program  disables  the  Control- 
Reset  feature,  you  need  to  turn  the  computer  off  to 
get  the  program  to  stop. 

copy  protect:  To  make  a  disk  uncopyable. 
Software  publishers  frequendy  try  to  copy  protect 
their  disks  to  prevent  them  from  being  illegally 
duplicated  by  software  pirates.  Compare  ■write 
protect. 


CPU:  See  central  processing  unit. 

CRT:  See  cathode-ray  tube. 

CTS:  See  Clear  To  Send. 

crash:  To  cease  to  operate  unexpectedly,  possibly 
destroying  information  in  the  process. 

current  input  device:  The  source,  such  as  the 
keyboard  or  a  modem,  from  which  a  program  is 
currently  receiving  its  input. 

current  output  device:  The  destination,  such  as 
the  display  screen  or  a  printer,  currendy  receiving 
a  program's  output. 

cursor:  A  symbol  displayed  on  the  screen 
marking  where  the  user's  next  action  will  take  effect 
or  where  the  next  character  typed  from  the 
keyboard  will  appear. 

DAC:  See  digital-to-analog  converter. 

data:  Information,  especially  information  used  or 
operated  on  by  a  program.  The  smallest  unit  of 
information  a  computer  can  understand  is  a  bit. 

data  bits:  The  bits  in  a  communication  transfer 
that  contain  information.  Compare  start  bit, 
stop  bit 

Data  Carrier  Detect  (DCD):  An  RS-232-C  signal 
from  a  DCE  (such  as  a  modem)  to  a  DTE  (such  as 
an  Apple  He)  indicating  that  a  communication 
connection  has  been  established.  See  Data 
Communication  Equipment,  Data  Terminal 
Equipment. 

Data  Communication  Equipment  (DCE):  As 

defined  by  the  RS-232-C  standard,  any  device  that 
transmits  or  receives  information.  Usually  this 
device  is  a  modem. 

data  format:  The  form  in  which  data  is  stored 
manipulated,  or  transferred. 

data  set:  A  device  that  modulates,  demodulates, 
and  controls  signals  transferred  between  business 
machines  and  communication  facilities.  A  form  of 
modem. 
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Data  Set  Ready  (DSR):  An  RS-232-C  signal  from  a 
DCE  to  a  DTE  indicating  that  the  DCE  has 
established  a  connection.  See  Data 
Communication  Equipment,  Data  Terminal 
Equipment, 

Data  Terminal  Equipment  (DTE):  As  defined 
by  the  RS-232-C  standard,  any  device  that 
generates  or  absorbs  information,  thus  acting  as 
an  endpoint  of  a  communication  connection.  A 
computer  might  serve  as  a  DTE. 

Data  Terminal  Ready  (DTR):  An  RS-232-C  signal 
from  a  DTE  to  a  DCE  indicating  a  readiness  to 
transmit  or  receive  data.  See  Data 
Communication  Equipment,  Data  Terminal 
Equipment. 

DCD:  See  Data  Carrier  Detect. 

DCE:  See  Data  Communication  Equipment. 

debug:  A  colloquial  term  that  means  to  locate  and 
correct  an  error  or  the  cause  of  a  problem  or 
malfunction  in  a  computer  program.  Compare 
troubleshoot.  See  also  bug. 

decimal:  The  common  form  of  number 
representation  used  in  everyday  life,  in  which 
numbers  are  expressed  in  in  the  base-10  system, 
using  the  ten  digits  0  through  9.  Compare  binary, 
hexadecimal. 

default:  A  preset  response  to  a  question  or 
prompt.  The  default  is  automatically  used  by  the 
computer  if  you  don't  supply  a  different  response. 
Default  values  prevent  a  program  from  stalling  or 
crashing  if  no  value  is  supplied  by  the  user. 

deferred  execution:  The  execution  of  a  BASIC 
program  instruction  that  is  part  of  a  complete 
program.  The  program  instruction  is  executed 
only  when  the  complete  program  is  run.  You  defer 
execution  of  the  instruction  by  preceding  it  with  a 
program  line  number.  The  complete  program 
executes  consecutive  instructions  in  numerical 
order.  Compare  immediate  execution. 


Delete  key:  A  key  on  the  upper-right  corner  of 
the  Apple  He  and  lie  keyboards  that  erases  the 
character  immediately  preceding  (to  the  left  of) 
the  cursor.  Similar  to  the  Macintosh  Backspace 
key. 

delimiter:  A  character  that  is  used  for 
punctuation  to  mark  the  beginning  or  end  of  a 
sequence  of  characters,  and  which  therefore  is  not 
considered  part  of  the  sequence  itself  For 
example,  Applesoft  BASIC  uses  the  double 
quotation  mark  (")  as  a  delimiter  for  string 
constants:  the  string  "DOG"  consists  of  the  three 
characters  D,  O,  and  G,  and  does  not  include  the 
quotation  marks. 

demodulate:  To  recover  the  information  being 
transmitted  by  a  modulated  signal.  For  example,  a 
conventional  radio  receiver  demodulates  an 
incoming  broadcast  signal  to  convert  it  into  the 
sound  emitted  by  the  radio's  speaker.  Compare 
modulate. 

device:  Frequently  used  as  a  short  form  of 
peripheral  device. 

device  driver:  A  program  that  manages  the 
transfer  of  information  between  the  computer  and 
a  peripheral  device. 

device  handler:  See  device  driver. 

digit:  (1)  One  of  the  characters  0  through  9,  used 
to  express  numbers  in  decimal  form.  (2)  One  of 
the  characters  used  to  express  numbers  in  some 
other  form,  such  as  0  and  1  in  binary  or  0  through 
9  and  A  through  F  in  hexadecimal. 

digital:  Represented  in  a  discrete  (noncontinuous) 
form,  such  as  numerical  digits  or  integers.  For 
example,  contemporary  digital  clocks  show  the 
time  as  a  digital  display  (such  as  2:57)  instead  of 
using  the  positions  of  a  pair  of  hands  on  a  clock 
face.  Compare  analog. 

digital  data:  Data  that  can  be  represented  by 
digits — that  is,  data  that  are  discrete  rather  than 
continuously  variable.  Compare  analog  data. 
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digital  signal:  A  signal  that  is  sent  and  received  in 
discrete  intervals.  A  signal  that  does  not  vary 
continuously  over  time.  Compare  analog  signal 

digital-to-analog  converter:  A  device  that 
converts  quantities  from  digital  to  analog  form. 

DIP:  See  dual  in-line  package. 

DIP  switches:  A  bank  of  tiny  switches,  each  of 
which  can  be  moved  manually  one  way  or  the 
other  to  represent  one  of  two  values  (usually  on 
and  off).  See  dual  in-line  package. 

disassembler:  A  language  translator  that 
converts  a  machine-language  program  into  an 
equivalent  program  in  assembly  language,  which 
is  easier  for  programmers  to  understand.  The 
opposite  of  an  assembler. 

disk:  An  information-storage  medium  consisting 
of  a  flat,  circular,  magnetic  surface  on  which 
information  can  be  recorded  in  the  form  of  small 
magnetized  spots,  in  a  manner  similar  to  the  way 
sounds  are  recorded  on  tape.  See  floppy  disk, 
hard  disk. 

disk-based:  See  disk-resident. 

disk  controller  card:  A  peripheral  card  that 
provides  the  connection  between  one  or  two  disk 
drives  and  the  computer.  This  connection,  or 
interface,  is  built  into  both  the  Apple  lie  and 
Macintosh-family  computers. 

disk  drive:  The  device  that  holds  a  disk,  retrieves 
information  from  it,  and  saves  information  to  it. 

disk  envelope:  A  removable,  protective  paper 
sleeve  used  when  handling  or  storing  a  5.25-inch 
disk.  It  must  be  removed  before  you  insert  the  disk 
in  a  disk  drive.  Compare  disk  jacket. 

disk  jacket:  A  permanent,  protective  covering  for 
a  disk.  5.25-inch  disks  have  flexible,  paper  or 
plastic  jackets;  3.5-inch  disks  have  hard  plastic 
jackets.  The  disk  is  never  removed  from  the  jacket. 
Compare  disk  envelope. 


Disk  Operating  System  (DOS):  An  optional 
software  system  for  the  Apple  II  family  of 
computers  that  enables  the  computer  to  control 
and  communicate  with  one  or  more  disk  drives. 
The  acronym  DOS  rhymes  with  boss. 

disk-resident:  An  adjective  describing  a  program 
that  does  not  remain  in  memory.  The  computer 
retrieves  all  or  part  of  the  program  from  the  disk, 
as  needed.  Sometimes  called  disk-based. 
Compare  memory-resident. 

Disk  n  drive:  An  older  type  of  disk  drive  made 
and  sold  by  Apple  Computer  for  use  with  the 
Apple  II,  II  Plus,  and  He.  It  uses  5.25-inch  disks. 

display:  (1)  A  general  term  to  describe  what  you 
see  on  the  screen  of  your  display  device  when 
you're  using  a  computer;  from  the  verb  form, 
which  means  "to  place  into  view."  (2)  Short  for  a 
display  device. 

display  color:  The  color  currently  being  used  to 
draw  high-resolution  or  low-resolution  graphics 
on  the  display  screen. 

display  device:  A  device  that  displays 
information,  such  as  a  television  set  or  video 
monitor. 

display  screen:  The  screen  of  the  monitor;  the 
area  where  you  view  text  and  pictures  when  using 
the  computer. 

DOS  3.2:  An  early  Apple  II  operating  system.  DOS 
stands  for  Disk  Operating  System;  3.2  is  the 

version  number.  Disks  formatted  using  DOS  3.2 
have  13  sectors  per  track. 

DOS  3.3:  An  operating  system  used  by  the  Apple  II 
family  of  computers.  DOS  stands  for  Disk 
Operating  System;  3.3  is  the  version  number. 
Disks  formatted  with  DOS  3.3  have  l6  sectors  per 
track. 

drive:  See  disk  drive. 

DSR:  See  Data  Set  Ready. 

DTE:  See  Data  Terminal  Equipment. 
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DTR:  See  Data  Terminal  Ready. 

dual  in-Une  package  (DIP):  An  integrated  circuit 
packaged  in  a  narrow  rectangular  box  with  a  row  of 
metal  pins  along  each  side.  DIP  switches  on  the 

box  allow  you  to  change  settings.  For  example, 
ImageWriter  printer  DIP  switches  control 
functions  such  as  line  feed,  form  length,  and  baud 
setting. 

Dvorak  keyboard:  An  alternate  keyboard  layout, 
also  known  as  the  American  Simplified  Keyboard, 
which  increases  typing  speed  because  the  keys 
most  often  used  are  in  the  positions  easiest  to 
reach.  Compare  QWERTY  keyboard. 

EBCDIC:  Acronym  for  Extended  Binary-Coded 
Decimal  Interchange  Code;  pronounced  "EB-si- 
dik."  A  code  used  by  IBM  that  represents  each 
letter,  number,  special  character,  and  control 
character  as  an  8-bit  binary  number.  EBCDIC  has 
a  character  set  of  256  8-bit  characters.  Compare 
ASCII. 

effective  address:  In  machine-language 
programming,  the  address  of  the  memory 
location  on  which  a  particular  instruction 
operates,  which  may  be  arrived  at  by  indexed 
addressing  or  some  other  addressing  method. 

80-colunin  text  card:  A  peripheral  card  that 
allows  the  Apple  II,  Apple  II  Plus,  and  Apple  He  to 
display  text  in  either  40  columns  or  80  columns. 

80/40-colunin  switch:  A  switch  that  controls  the 
maximum  number  of  columns  or  characters 
across  the  screen.  A  television  can  legibly  display 
a  maximum  of  40  characters  across  the  screen, 
whereas  a  video  monitor  can  display  80 
characters. 

embedded:  Contained  within.  For  example,  the 
string  'HUMPTY  DUMPTY'  is  said  to  contain  an 
embedded  space. 


em.ulate:  To  operate  in  a  way  identical  to  a 
different  system.  For  example,  the  Apple  II 
2780/3780  Protocol  Emulator  and  the  Apple  II 
3270  BSC  Protocol  Emulator,  together  with  the 
Apple  Communications  Protocol  Card  (ACPC), 
allow  the  Apple  II,  Apple  II  Plus,  or  Apple  He  to 
emulate  the  operations  of  IBM  3278  and  3277 
terminals  and  3274  and  3271  control  units. 

emulation  mode:  A  mode  of  operation  in  which 
the  computer  is  emulating  the  operation  of 
another  computer  or  interface.  See  emulate. 

end-of-command  mark:  A  punctuation  mark 
used  to  separate  commands  sent  to  a  peripheral 
device  such  as  a  printer  or  plotter.  Also  called  a 
command  terminator. 

end-of-line  character:  A  character  which 
indicates  that  the  preceding  text  constitutes  a  full 
line. 

error  code:  A  number  or  other  symbol 
representing  a  type  of  error. 

error  message:  A  message  displayed  or  printed 
to  tell  you  of  an  error  or  problem  in  the  execution 
of  a  program  or  in  your  communication  with  the 
system.  An  error  message  is  often  accompanied 
by  a  beep. 

escape  character:  An  ASCII  character  that,  with 
many  programs  and  devices,  allows  you  to 
perform  special  functions  when  used  in 
combination  keypresses. 

escape  code:  A  sequence  of  characters  that  begins 
with  an  ESCAPE  character  and  constitutes  a 
complete  command.  Usually  synonymous  with 
escape  sequence. 

Escape  key:  A  key  on  Apple  Il-family  computers 
that  generates  the  ESCAPE  character.  The  Escape 
key  is  labeled  Esc.  In  many  applications,  pressing 
Esc  allows  you  to  return  to  a  previous  menu  or  to 
stop  a  procedure. 
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escape  mode:  A  state  of  the  Apple  He  and  lie 
entered  by  pressing  the  Esc  key  and  certain  other 
keys.  The  other  keys  take  on  special  meanings  for 
positioning  the  cursor  and  controlling  the  display 
of  text  on  the  screen. 

escape  sequence:  A  sequence  of  keystrokes, 
beginning  with  the  Esc  key.  In  escape  mode, 
escape  sequences  are  used  for  positioning  the 
cursor  and  controlling  the  display  of  text  on  the 
screen.  Escape  sequences  are  also  used  as  codes  to 
control  printers. 

Esc  key:  See  Escape  key. 

even/odd  parity  check:  In  data  transmission,  a 
check  that  tests  whether  the  number  of  1  bits  in  a 
group  of  binary  digits  is  even  (even  parity  check) 
or  odd  (odd  parity  check). 

even  parity:  In  data  transmission,  the  use  of  an 
extra  bit  set  to  0  or  1  as  necessary  to  make  the  total 
number  of  1  bits  an  even  number;  used  as  a  means 
of  error  checking.  Compare  MARK  parity,  odd 
parity. 

exclusive  OR:  A  logical  operator  that  produces  a 
true  result  if  one  of  its  operands  is  true  and  the 
other  false,  and  a  false  result  if  its  operands  are 
both  true  or  both  false.  Compare  OR,  AND,  and 
NOT. 

execute:  To  perform  the  actions  specified  by  a 
program  command  or  sequence  of  commands. 

expansion  slot:  A  connector  into  which  you  can 
install  a  peripheral  card.  Sometimes  called  a 
peripheral  slot.  See  also  auxiliary  slot 

expression:  A  formula  in  a  program  that  defines 
a  calculation  to  be  performed. 

FIFO:  Acronym  for  "first  in,  first  out"  order,  as  in 
a  queue. 

file:  Any  named,  ordered  collection  of 
information  stored  on  a  disk.  Application 
programs  and  operating  systems  on  disks  are  files. 
You  make  a  file  when  you  create  text  or  graphics, 
give  the  material  a  name,  and  save  it  to  disk. 


firmware:  Programs  stored  permanently  in  read- 
only memory  (ROM).  Such  programs  (for 
example,  the  Applesoft  Interpreter  and  the 
Monitor  program)  are  built  into  the  computer  at 
the  factory.  They  can  be  executed  at  any  time  but 
cannot  be  modified  or  erased  from  main 
memory.  Compare  hardware,  software. 

fixed-point:  A  method  of  representing  numbers 
inside  the  computer  in  which  the  decimal  point 
(more  correctly,  the  binary  point)  is  considered 
to  occur  at  a  fixed  position  within  the  number. 
Typically,  the  point  is  considered  to  lie  at  the  right 
end  of  the  number  so  that  the  number  is 
interpreted  as  an  integer.  Compare  floating- 
point. 

flag:  A  variable  whose  value  (usually  1  or  0, 
standing  for  true  or  false)  indicates  whether  some 
condition  holds  or  whether  some  event  has 
occurred.  A  flag  is  used  to  control  the  program's 
actions  at  some  later  time. 

floating-point:  A  method  of  representing 
numbers  inside  the  computer  in  which  the  decimal 
point  (more  correctly,  the  binary  point)  is 
permitted  to  "float"  to  different  positions  within 
the  number.  Some  of  the  bits  within  the  number 
itself  are  used  to  keep  track  of  the  point's  position. 
Compare  fixed-point. 

floppy  disk:  A  disk  made  of  flexible  plastic,  as 
compared  to  a  hard  disk,  which  is  made  of  metal. 
The  term  floppy  is  now  usually  applied  only  to 
disks  with  thin,  flexible  disk  jackets,  such  as  5.25- 
inch  disks.  With  3.5-inch  disks,  the  disk  itself  is 
flexible,  but  the  jacket  is  made  of  hard  plastic; 
thus,  3.5-inch  disks  aren't  particularly  "floppy." 

format:  (n)  (1)  The  form  in  which  information  is 
organized  or  presented.  (2)  The  general  shape  and 
appearance  of  a  printed  page,  including  page  size, 
character  width  and  spacing,  line  spacing,  and  so 
on.  (v)  To  divide  a  disk  into  tracks  and  sectors 
where  information  can  be  stored.  Blank  disks  must 
be  formatted  before  you  can  save  information  on 
them  for  the  first  time;  same  as  initialize. 
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form  feed:  An  ASCII  character  (decimal  12)  that 
causes  a  printer  or  other  paper-handling  device  to 
advance  to  the  top  of  the  next  page. 

Fortran:  Short  for  Formula  Translator.  A  high- 
level  programming  language  especially  suitable 
for  applications  requiring  extensive  numerical 
calculations,  such  as  in  mathematics, 
engineering,  and  the  sciences. 

framing  error:  In  serial  data  transfer,  the 
absence  of  the  expected  stop  bit(s)  at  the  end  of  a 
received  character. 

frequency:  In  alternating  current  (AC)  signals, 
the  number  of  complete  cycles  transmitted  per 
second.  Frequency  is  usually  expressed  in  hertz 
(cycles  per  second),  kilohertz  (kilocycles  per 
second),  or  megahertz  (megacycles  per  second). 
In  acoustics,  frequency  of  vibration  determines 
musical  pitch.  Compare  duration. 

full  duplex;  A  four-wire  communication  circuit  or 
protocol  that  allows  two-way  data  transmission 
between  two  points  at  the  same  time.  Compare 
half  duplex. 

function:  A  preprogrammed  calculation  that  can 
be  carried  out  on  request  from  any  point  in  a 
program.  A  function  takes  in  one  or  more 
arguments  and  returns  a  single  value.  It  can 
therefore  be  embedded  in  an  expression. 

game  I/O  connector:  A  l6-pin  connector  inside 
the  Apple  II,  II  Plus,  and  He,  originally  designed 
for  connecting  hand  controls  to  the  computer,  but 
also  used  for  connecting  some  other  peripheral 
devices.  Compare  hand  control  connector. 

graph:  A  pictorial  representation  of  data. 

graphics:  (1)  Information  presented  in  the  form 
of  pictures  or  images.  (2)  The  display  of  pictures 
or  images  on  a  computer's  display  screen. 
Compare  text. 


half  duplex:  A  two-wire  communication  circuit  or 
protocol  designed  for  data  transmission  in  either 
direction  but  not  both  directions  simultaneously. 
Compare  ftill  duplex. 

hand  control  connector:  A  9-pin  connector  on 
the  back  panel  of  the  Apple  He  and  He  computers, 
used  for  connecting  hand  controls  to  the 
computer.  Compare  game  I/O  connector. 

hand  controller:  Peripheral  devices,  with 
rotating  dials  and  push  buttons.  Hand  controllers 
are  used  to  control  game-playing  programs,  but 
they  can  also  be  used  in  other  applications. 

hang:  To  cease  operation  because  either  an 
expected  condition  is  not  satisfied  or  an  infinite 
loop  is  occurring.  A  computer  that's  hanging  is 
called  a  hung  system.  Compare  crash. 

hard  disk:  A  disk  made  of  metal  and  sealed  into  a 
drive  or  cartridge.  A  hard  disk  can  store  very  large 
amounts  of  information  compared  to  a  floppy 
disk. 

hard  disk  drive;  A  device  that  holds  a  hard  disk, 
retrieves  information  from  it,  and  saves 
information  to  it.  Hard  disks  made  for 
microprocessors  are  permanently  sealed  into  the 
drives. 

hardware:  In  computer  terminology,  the 
machinery  that  makes  up  a  computer  system. 
Compare  firmware,  software. 

hertz;  The  unit  of  frequency  of  vibration  or 
oscillation,  defined  as  the  number  of  cycles  per 
second.  Named  for  the  physicist  Heinrich  Hertz 
and  abbreviated  Hz.  The  6502  microprocessor 
used  in  the  Apple  II  systems  operates  at  a  dock 
frequency  of  about  1  million  hertz,  or  1  megahertz 
(MHz).  The  68000  microprocessor  used  in  the 
Macintosh  operates  at  7.8336  MHz. 
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hexadecimal:  The  representation  of  numbers  in 
the  base-l6  system,  using  the  ten  digits  0  through  9 
and  the  six  letters  A  through  F.  For  example,  the 
decimal  numbers  0,  1,  2,  3,  4,  ...  8,  9,  10,  11,  ... 
15,  16,  17  would  be  shown  in  hexadecimal 
notation  as  00,  01,  02,  03,  04,  ...  08,  09,  OA,  OB, 
...  OF,  10,  11.  Hexadecimal  numbers  are  easier  for 
people  to  read  and  understand  than  are  binary 
numbers,  and  they  can  be  converted  easily  and 
directly  to  binary  form.  Each  hexadecimal  digit 
corresponds  to  a  sequence  of  four  binary  digits, 
or  bits.  Hexadecimal  numbers  are  usually 
preceded  by  a  dollar  sign  ($). 

high  ASCn  characters:  ASCII  characters  with 
decimal  values  of  128  to  255.  Called  high  ASCII 
because  their  high  bit  (first  binary  digit)  is  set  to  1 
(for  on)  rather  than  0  (for  off). 

high-level  language:  A  programming  language 
that  is  relatively  easy  for  people  to  understand.  A 
single  statement  in  a  high-level  language  typically 
corresponds  to  several  instructions  of  machine 
language.  High-level  languages  available  from 
Apple  Computer  include  BASIC,  Pascal,  Instant 
Pascal,  Logo,  Pilot,  SuperPILOT,  and  Fortran. 
Compare  low-level  language. 

high-order  byte:  The  more  significant  half  of  a 
memory  address  or  other  two-byte  quantity.  In  the 
6502  microprocessor  used  in  the  Apple  II  family  of 
computers,  the  low-order  byte  of  an  address  is 
usually  stored  first,  and  the  high-order  byte 
second.  In  the  68000  microprocessors  used  in  the 
Macintosh  family,  the  high-order  byte  is  stored 
first. 

high-resolution  graphics:  The  display  of 
graphics  on  a  screen  as  a  six-color  array  of  points, 
280  columns  wide  and  192  rows  high.  When  a  text 
window  is  in  use,  the  visible  high-resolution 
graphics  display  is  280  by  l60  points. 

hold  time:  In  computer  circuits,  the  amount  of 
time  a  signal  must  remain  valid  after  some  related 
signal  has  been  turned  off.  Compare  setup  time. 

Hz:  See  hertz. 


IC:  See  integrated  circuit 

Immediate  execution:  The  execution  of  a 
program  statement  as  soon  as  it  is  typed.  In 
BASIC,  immediate  execution  occurs  when  the  line 
is  typed  without  a  line  number;  immediate 
execution  allows  you  to  try  out  nearly  every 
statement  immediately  to  see  how  it  works. 
Compare  deferred  execution. 

implement:  To  put  into  practical  effect,  as  to 
implement  a  plan.  For  example,  a  language 
translator  implements  a  particular  language. 

IN#:  This  command  designates  the  source  of 
subsequent  input  characters.  It  can  be  used  to 
designate  a  device  in  a  slot  or  a  machine-language 
routine  as  the  source  of  input. 

index:  (1)  A  number  used  to  identify  a  member  of 
a  list  or  table  by  its  sequential  position.  (2)  A  list  oi 
table  whose  entries  are  identified  by  sequential 
position.  (3)  In  machine-language  programming, 
the  variable  component  of  an  indexed  address, 
contained  in  an  index  register  and  added  to  the 
base  address  to  form  the  effective  address. 

indexed  addressing:  A  method  used  in  machine 
language  programming  to  specify  memory 
addresses.  See  also  memory  location. 

index  register:  A  register  in  a  computer 
processor  that  holds  an  index  for  use  in  indexed 
addressing.  The  6502  microprocessor  used  in  the 
Apple  II  family  of  computers  has  two  index 
registers,  called  the  X  register  and  the  Y 
register.  The  68000  microprocessor  used  in 
Macintosh-family  computers  has  l6  registers  that 
can  be  used  as  index  registers. 

index  variable:  A  variable  whose  value  changes 
on  each  pass  through  a  loop.  Often  called  control 
variable  or  loop  variable. 

infinite  loop:  A  section  of  a  program  that  will 
repeat  the  same  sequence  of  actions  indefinitely. 
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Initialize:  (1)  To  set  to  an  initial  state  or  value  in 
preparation  for  some  computation.  (2)  To 
prepare  a  blank  disk  to  receive  information  by 
organizing  its  surface  into  tracks  and  sectors;  same 
as  format. 

initialized  disk:  A  disk  that  has  been  organized 
into  tracks  and  sectors  by  the  computer  and  is 
therefore  ready  to  store  information. 

input:  Information  transferred  into  a  computer 
from  some  external  source,  such  as  the  keyboard, 
a  disk  drive,  or  a  modem. 

input/output  (I/O):  The  process  by  which 
information  is  transferred  between  the  computer's 
memory  and  its  keyboard  or  peripheral  devices. 

input  routine:  A  machine-language  routine;  the 
standard  input  routine  reads  characters  from  the 
keyboard.  A  different  input  routine  might,  for 
example,  read  them  from  an  external  terminal. 

instruction:  A  unit  of  a  machine-language  or 
assembly-language  program  corresponding  to  a 
single  action  for  the  computer's  processor  to 
perform. 

integer:  A  whole  number  in  fixed-point  form. 
Compare  real  number. 

Integer  BASIC:  A  version  of  the  BASIC 
programming  language  used  by  the  Apple  II  family 
of  computers.  Integer  BASIC  is  older  than 
Applesoft  BASIC  and  is  capable  of  processing 
numbers  in  integer  (fixed-point)  form  only.  Many 
games  are  written  in  Integer  BASIC  because  its 
instructions  can  be  executed  very  quickly. 
Compare  Applesoft  BASIC. 

integrated  circuit:  An  electronic 
:ircuit — including  components  and 
nterconnections — entirely  contained  in  a  single 
piece  of  semiconducting  material,  usually  silicon. 
Dften  referred  to  as  an  /C  or  a  chip. 


interface:  (1)  The  point  at  which  independent 
systems  or  diverse  groups  interact.  The  devices, 
rules,  or  conventions  by  which  one  component  of 
a  system  communicates  with  another.  Also,  the 
point  of  communication  between  a  person  and  a 
computer.  (2)  The  part  of  a  program  that  defines 
constants,  variables,  and  data  structures,  rather 
than  procedures. 

interface  card:  A  peripheral  card  that 
implements  a  particular  interface  (such  as  a 
parallel  or  serial  interface)  by  which  the  computer 
can  communicate  with  a  peripheral  device  such  as 
a  printer  or  modem. 

interpreter:  A  language  translator  that  reads  a 
program  instruction  by  instruction  and 
immediately  translates  each  instruction  for  the 
computer  to  carry  out.  Compare  compiler. 

interrupt:  A  temporary  suspension  in  the 
execution  of  a  program  that  allows  the  computer  to 
f)erform  some  other  task,  typically  in  response  to  a 
signal  from  a  peripheral  device  or  other  source 
external  to  the  computer. 

inverse  video;  The  display  of  text  on  the 
computer's  display  screen  in  the  form  of  dark  dots 
on  a  light  (or  other  single  phosphor  color) 
background,  instead  of  the  usual  light  dots  on  a 
dark  background. 

I/O:  See  input/output. 

I/O  device:  Input/output  device.  A  device  that 
transfers  information  into  or  out  of  a  computer. 
See  input,  output,  peripheral  device. 

I/O  link:  A  fixed  location  that  contains  the 
address  of  an  input/output  subroutine  in  the 
computer's  Monitor  program. 

IWM:  "Integrated  Woz  Machine";  the  custom  chip 
that  controls  Apple's  3.5-inch  disk  drives. 

joystick:  A  peripheral  device  with  a  lever, 
typically  used  to  move  creatures  and  objects  in 
game  programs;  a  joystick  can  also  used  in 
applications  such  as  computer-aided  design  and 
graphics  programs. 
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K:  See  kilobyte. 

keyboard:  The  set  of  keys,  similar  to  a  typewriter 
keyboard,  used  for  entering  information  into  the 
computer. 

keyboard  input  connector:  The  connector 
inside  the  Apple  II  family  of  computers  by  which 
the  keyboard  is  connected  to  the  computer. 

keyword:  A  special  word  or  sequence  of 
characters  that  identifies  a  particular  type  of 
statement  or  command,  such  as  RUN,  BRUN,  or 
PRINT. 

kilobyte  (K):  A  unit  of  measurement  consisting  of 
1024  (2^^  bytes.  In  this  usage,  kilo  (from  the 
Greek,  meaning  a  thousand)  stands  for  1024.  Thus, 
64K  memory  equals  65,536  bytes.  See  also 
megabyte. 

KSW:  The  symbolic  name  of  the  location  in  the 
computer's  memory  where  the  standard  input  link 
(namely,  to  the  keyboard)  is  stored.  /r5\r  stands 
for  keyboard  switch. 

language:  See  programming  language. 

language  card:  A  peripheral  card  that,  when 
placed  in  slot  0  of  a  48K  Apple  II  or  Apple  II  Plus, 
gives  the  computer  a  total  of  64K  of  memory.  If 
you  have  an  Apple  II  or  Apple  II  Plus,  you  need  a 
language  card  or  the  equivalent  to  use  ProDOS. 

language  translator:  A  system  program  that 
reads  another  program  written  in  a  particular 
programming  language  and  either  executes  it 
directly  or  converts  it  into  some  other  language 
(such  as  machine  language)  for  later  execution. 
See  interpreter,  compiler,  assembler. 

leading  zero:  A  zero  occurring  at  the  beginning  of 
a  decimal  number,  deleted  by  most  computing 
programs. 

least  significant  bit:  The  rightmost  bit  of  a  binary 
number.  The  least  significant  bit  contributes  the 
smallest  quantity  to  the  value  of  the  number. 
Compare  most  significant  bit. 


UFO:  Acronym  for  "last  in,  first  out"  order,  as  in 
a  stack. 

line:  See  program  line. 

line  feed;  An  ASCII  character  (decimal  10)  that 
ordinarily  causes  a  printer  or  video  display  to 
advance  to  the  next  line. 

line  number:  A  number  identifying  a  program 
line  in  an  Applesoft  BASIC  program. 

line  width:  The  number  of  characters  that  fit  on  a 
line  on  the  screen  or  on  a  page. 

list:  To  display  on  a  monitor,  or  print  on  a 
printer,  the  contents  of  memory  or  of  a  file. 

load:  To  transfer  information  from  a  peripheral 
storage  medium  (such  as  a  disk)  into  main 
memory  for  use — for  example,  to  transfer  a 
program  into  memory  for  execution. 

locaL  Connected  to  or  close  by  the  host  system. 

location:  See  memory  location. 

logic  (1)  In  microcomputers,  a  mathematical 
treatment  of  formal  logic  using  a  set  of  symbols  to 
represent  quantities  and  relationships  that  can  be 
translated  into  switching  circuits,  or  gates.  AND, 
OR,  and  NOT  are  examples  of  logical  gates.  Each 
gate  has  two  states,  open  or  closed,  allowing  the 
application  of  binary  numbers  for  solving 
problems.  (2)  The  systematic  scheme  that  defines 
the  interactions  of  signals  in  the  design  of  an 
automatic  data  processing  system. 

logical  operator:  An  operator,  such  as  AND,  tha 
combines  logical  values  to  produce  a  logical 
result,  such  as  true  or  false;  sometimes  called  a 
Boolean  operator.  Compare  arithmetic 
operator,  relational  operator. 

logic  board:  See  main  logic  board. 

loop;  A  section  of  a  program  that  is  executed 
repeatedly  until  a  limit  or  condition  is  met,  such  ; 
an  index  variable's  reaching  a  specified  ending 
value.  See  loop. 

loop  variable:  See  index  variable. 
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low-level  language:  A  programming  language 
that  is  relatively  close  to  the  form  the  computer's 
processor  can  execute  directly.  One  statement  in  a 
low-level  language  corresponds  to  a  single 
machine-language  instruction.  Examples  are  6502 
machine  language,  6502  assembly  language,  and 
68000  machine  and  assembly  languages.  Compare 
high-level  language. 

lo'w-order  byte:  The  less  significant  half  of  a 
memory  address  or  other  two-byte  quantity.  In  the 
6502  microprocessor  used  in  the  Apple  II  family  of 
computers,  the  low-order  byte  of  an  address  is 
usually  stored  first,  and  the  high-order  byte 
second.  The  opposite  is  true  for  Macintosh 
computers. 

low-power  Schottky  (LS):  A  type  of  transistor- 
transistor  logic  (TTL)  integrated  circuit  having 
lower  power  and  higher  speed  than  a  conventional 
TTL  integrated  circuit;  named  for  Walter  Schottky 
(1886-1956),  a  semiconductor  physicist. 

low-resolution  graphics:  The  display  of  graphics 
on  a  display  screen  as  a  l6-color  array  of  blocks, 
40  columns  wide  and  48  rows  high.  For  example, 
on  a  Macintosh  when  the  text  window  is  in  use,  the 
visible  low-resolution  graphics  display  is  40  by  40 
plotting  points — that  is,  40  by  40  pixels.  See  high- 
resolution  graphics. 

LS:  See  low-power  Schottky. 

machine  language:  The  form  in  which 
instructions  to  a  computer  are  stored  in  memory 
for  direct  execution  by  the  computer's  processor. 
Each  model  of  computer  processor  (such  as  the 
6502  microprocessor  used  in  the  Apple  II  family  of 
computers)  has  its  own  form  of  machine  language. 

mainframe  computer:  A  central  processing  unit 
or  computer  that  is  larger  and  more  powerful  than 
a  minicomputer  or  a  personal  computer 
(microcomputer).  Frequently  called  simply  a 
mainframe  for  short.The  Apple  Access  II 
program  and  MacTerminal  make  it  possible  to 
communicate  with  mainframe  computers  over 
telecommunications  media. 


main  logic  board:  A  large  circuit  board  that  holds 
RAM,  ROM,  the  microprocessor,  custom- 
integrated  circuits,  and  other  components  that 
make  the  computer  a  computer. 

main  memory:  The  part  of  a  computer's 
memory  whose  contents  are  direcdy  accessible  to 
the  microprocessor;  usually  synonymous  with 
random-access  memory  (RAM).  Programs  are 
loaded  into  main  memory,  and  that's  where  the 
computer  keeps  information  while  you're  working. 
Sometimes  simply  called  memory.  See  also  read- 
only memory,  read-write  memory. 

MARK  parity:  A  bit  of  value  1  appended  to  a 
binary  number  for  transmission.  The  receiving 
device  checks  for  errors  by  looking  for  this  value 
on  each  character.  Compare  even  parity,  odd 
parity. 

megabyte:  A  unit  of  measurement  equal  to  1024 
kilobytes,  or  1,048,576  bytes;  abbreviated  Mb.  See 
kilobyte. 

memory;  A  hardware  component  of  a  computer 
system  that  can  store  information  for  later 
retrieval.  See  main  memory,  random-access 
memory,  read-only  memory,  read-write 
memory. 

memory  location:  A  unit  of  main  memory  that  is 
identified  by  an  address  and  can  hold  a  single  item 
of  information  of  a  fixed  size.  In  the  Apple  II 
family  of  computers,  a  memory  location  holds 
one  byte,  or  eight  bits,  of  information. 

memory-resident:  (1)  Stored  permanentiy  in 
memory  as  firmware  (ROM).  (2)  Held  continually 
in  memory  even  while  not  in  use.  DOS  is  a 
memory-resident  program. 

menu:  A  list  of  choices  presented  by  a  program, 
from  which  you  can  select  an  action. 

MHz:  Megahertz;  one  million  hertz.  See  hertz. 

microcomputer:  A  computer,  such  as  any  of  the 
Apple  II  or  Macintosh  computers,  whose 
processor  is  a  microprocessor. 
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microprocessor:  A  computer  processor 
contained  in  a  single  integrated  circuit,  such  as  the 
6502  or  65C02  microprocessor  used  in  the  Apple  II 
family  of  computers  and  the  68000 
microprocessor  used  in  the  Macintosh  family.  The 
microprocessor  is  the  central  processing  unit 
(CPU)  of  the  microcomputer. 

microsecond:  One  millionth  of  a  second. 
Abbreviated  \is. 

millisecond:  One  thousandth  of  a  second. 
Abbreviated  ms. 

mode:  A  state  of  a  computer  or  system  that 
determines  its  behavior.  A  manner  of  operating. 

modem:  Short  for  MOdulator/DEModulator. 
A  peripheral  device  that  links  your  computer  to 
other  computers  and  information  services  using 
the  telephone  lines. 

modifier  key:  A  key  (Apple,  Caps  Lock,  Control, 
Option,  Shift)  that  generates  no  keyboard  events 
of  its  own,  but  changes  the  meaning  of  other  keys 
or  mouse  actions.  Also  called  a  control  key. 

modulate:  To  modify  or  alter  a  signal  so  as  to 
transmit  information.  For  example,  conventional 
broadcast  radio  transmits  sound  by  modulating 
the  amplitude  (amplitude  modulation,  or  AM)  or 
the  frequency  (frequency  modulation,  or  FM)  of  a 
carrier  signal. 

monitor:  See  video  monitor. 

Monitor  program:  A  system  program  built  into 
the  firmware  of  some  computers,  used  for  directly 
inspecting  or  changing  the  contents  of  main 
memory  and  for  operating  the  computer  at  the 
machine-language  level.  The  Monitor  program 
activates  the  disk  drive  when  you  turn  on  the 
computer. 

most  significant  bit:  The  leftmost  bit  of  a  binary 
number.  The  most  significant  bit  contributes  the 
largest  quantity  to  the  value  of  the  number.  For 
example,  in  the  binary  number  10110  (decimal 
value  22),  the  leftmost  bit  has  the  decimal  value  16 
(2'^).  Compare  least  significant  bit 


mouse:  A  small  device  you  move  around  on  a  flat 
surface  next  to  your  computer.  The  mouse 
controls  a  pointer  on  the  screen  whose 
movements  correspond  to  those  of  the  mouse. 
You  use  the  pointer  to  select  menu  items,  to  move 
data,  and  to  draw  with  in  graphics  programs. 

mouse  button:  The  button  on  the  top  of  the 
mouse.  In  general,  pressing  the  mouse  button 
initiates  some  action  on  whatever  is  under  the 
pointer,  and  releasing  the  button  confirms  the 
action. 

nanosecond:  One  billionth  of  a  second. 
Abbreviated  ns. 

nested  loop:  A  loop  contained  within  the  body  of 
another  loop  and  executed  repeatedly  during  each 
pass  through  the  outer  loop.  See  loop. 

nested  subroutine  call:  A  call  to  a  subroutine 
from  within  the  body  of  another  subroutine. 

nibble:  A  unit  of  data  equal  to  half  a  byte,  or  four 
bits.  A  nibble  can  hold  any  value  from  0  to  15. 

NOT:  A  unary  logical  operator  that  produces  a  true 
result  if  its  operand  is  false,  and  a  false  result  if  its 
operand  is  true.  Compare  AND,  OR,  exclusive 
OR. 

NTSQ  (1)  Abbreviation  for  National  Television 
Standards  Committee.  The  committee  that 
defined  the  standard  format  used  for  transmitting 
broadcast  video  signals  in  the  United  States.  (2) 
The  standard  video  format  defined  by  the  NTSC. 

object  code:  See  object  program. 

object  program:  The  translated  form  of  a 
program  produced  by  a  language  translator  such 
as  a  compiler  or  assembler.  Also  called  object 
code.  Compare  source  program. 

odd  parity:  In  data  transmission,  the  use  of  an 
extra  bit  set  to  0  or  1  as  necessary  to  make  the  total 
number  of  1  bits  an  odd  number;  used  as  a  means 
of  error  checking.  Compare  even  parity,  MARK 
parity. 

opcode:  See  operation  code. 
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Open  Apple:  A  control  key  on  the 

Apple  Il-family  keyboards;  on  later  keyboards, 
simply  called  the  Apple  key. 

operand:  A  value  to  which  an  operator  is  applied. 
The  value  on  which  an  operation  code  operates. 
Compare  argument. 

operating  system:  A  program  that  organizes  the 
actions  of  the  parts  of  the  computer  and  its 
peripheral  devices.  See  disk  operating  system. 

operation  code:  The  part  of  a  machine-language 
instruction  that  specifies  the  operation  to  be 
performed.  Often  called  opcode. 

operator:  A  symbol  or  sequence  of  characters, 
such  as  +  or  AND,  specifying  an  operation  to  be 
performed  on  one  or  more  values  (the  operands) 
to  produce  a  result.  See  arithmetic  operator, 
relational  operator,  logical  operator,  unary 
operator,  binary  operator. 

option:  (1)  Something  chosen  or  available  as  a 
choice;  for  instance,  items  in  a  menu.  (2)  An 
argument  whose  provision  is  optional. 

OR:  A  logical  operator  that  produces  a  true  result  if 
either  or  both  of  its  operands  are  true,  and  a  false 
result  if  both  of  its  operands  are  false.  Compare 
exclusive  OR,  AND,  NOT. 

output:  Information  transferred  from  a  computer 
to  some  external  destination,  such  as  the  display 
screen,  a  disk  drive,  a  printer,  or  a  modem. 

output  routine:  A  machine-language  routine  that 
performs  the  sending  of  characters.  The  standard 
output  routine  sends  characters  to  the  screen.  A 
different  output  routine  might,  for  example,  send 
them  to  a  printer. 

overflo^v:  The  condition  that  exists  when  an 
attempt  is  made  to  put  more  data  into  a  given 
memory  area  than  it  can  hold;  for  example,  a 
computational  result  that  exceeds  the  allowed 
range. 

override:  To  modify  or  cancel  an  instruction  by 
issuing  another  one. 


overrun:  A  condition  that  occurs  when  the 
processor  does  not  retrieve  a  received  character 
from  the  receive  data  register  of  the  Asynchronous 
Communications  Interface  Adapter  (ACIA)  before 
the  subsequent  character  arrives.  The  ACIA 
automatically  sets  bit  2  (OVR)  of  its  status  register; 
subsequent  characters  are  lost.  The  receive  data 
register  contains  the  last  valid  data  word  received. 

page:  CD  A  screenful  of  information  on  a  video 
display.  In  the  Apple  II  family  of  computers,  a 
page  consists  of  24  lines  of  40  or  80  characters 
each.  (2)  An  area  of  main  memory  containing  text 
or  graphical  information  being  displayed  on  the 
screen.  (3)  A  segment  of  main  memory  256  bytes 
long  and  beginning  at  an  address  that  is  an  even 
multiple  of  256. 

page  zero:  See  zero  page. 

parallel  interface:  An  interface  in  which  several 
bits  of  information  (typically  8  bits,  or  1  byte)  are 
transmitted  simultaneously  over  different  wires  or 
channels.  Compare  serial  interface. 

parity:  Sameness  of  level  or  count,  usually  the 
count  of  1  bits  in  each  character,  used  for  error 
checking  in  data  transmission.  See  even  parity, 
MARK  parity,  odd  parity,  parity  bit. 

Pascal:  A  high-level  programming  language  with 
Statements  that  resemble  English  phrases.  Pascal 
was  designed  to  teach  programming  as  a 
systematic  approach  to  problem  solving.  Named 
after  the  philosopher  and  mathematician  Blaise 
Pascal. 

pass:  A  single  execution  of  a  loop. 

PC  board:  See  printed-circuit  board. 

peek:  To  read  information  directly  from  a 
location  in  the  computer's  memory. 

peripheral:  (adj)  At  or  outside  the  boundaries  of 
the  computer  itself,  either  physically  (as  a 
peripheral  device)  or  in  a  logical  sense  (as  a 
peripheral  card),  (n)  Short  for  peripheral  device. 
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peripheral  bus:  The  bus  used  for  transmitting 
information  between  the  computer  and  peripheral 
devices  connected  to  the  computer's  expansion 
slots  or  ports. 

peripheral  card:  A  removable  printed-circuit 
board  that  plugs  into  one  of  the  computer's 
expansion  slots.  Peripheral  cards  allow  the 
computer  to  use  peripheral  devices  or  to  perform 
some  subsidiary  or  peripheral  function. 

peripheral  device:  A  piece  of  hardware — such  as 
a  video  monitor,  disk  drive,  printer,  or 
modem — used  in  conjunction  with  a  computer 
and  under  the  computer's  control.  Peripheral 
devices  are  often  Obut  not  necessarily)  physically 
separate  from  the  computer  and  connected  to  it  by 
wires,  cables,  or  some  other  form  of  interface. 
They  often  require  peripheral  cards. 

peripheral  slot:  See  expansion  slot. 

phase:  (1)  A  stage  in  a  periodic  process.  A  point 
in  a  cycle.  For  example,  the  6502  microprocessor 
uses  a  dock  cycle  consisting  of  two  phases  called 
O  0  and  0  1.  (2)  The  relationship  between  two 
periodic  signals  or  processes. 

PILOT:  Acronym  for  Programmed  Inquiry, 
Learning,  Or  Teaching.  A  high-level  programming 
language  designed  for  teachers  and  used  to  create 
computer-aided  instruction  (CAI)  lessons  that 
include  color  graphics,  sound  effects,  lesson  text, 
and  answer  checking.  SuperPILOT  is  an  enhanced 
version  of  the  original  Apple  II  PILOT 
programming  language. 

pipelining:  A  feature  of  a  processor  that  enables  it 
to  begin  fetching  the  next  instruction  before  it  has 
finished  executing  the  current  instruction.  All  else 
being  equal,  processors  with  this  feature  run  faster 
than  those  without  it. 

pixel:  Short  for  picture  element.  A  point  on  the 
graphics  screen;  the  visual  representation  of  a 
bit  on  the  screen  (white  if  the  bit  is  0,  black  if 
it's  1).  Also,  a  location  in  video  memory  that 
maps  to  a  point  on  the  graphics  screen  when  the 
viewing  window  includes  that  location. 


plotting  vector:  A  code  representing  a  single  step 
in  drawing  a  shape  on  the  high-resolution  graphics 
screen.  The  plotting  vector  specifies  whether  to 
plot  a  point  at  the  current  screen  position,  and  in 
what  direction  to  move  (up,  down,  left,  or  right) 
before  processing  the  next  vector.  See  shape 
definition,  shape  table. 

pointer:  An  item  of  information  consisting  of  the 
memory  address  of  some  other  item.  For 
example,  Applesoft  BASIC  maintains  internal 
pointers  to  the  most  recently  stored  variable,  the 
most  recently  typed  program  line,  and  the  most 
recently  read  data  item,  among  other  things.  The 
6502  uses  one  of  its  internal  registers  as  a  pointer  to 
the  top  of  the  stack. 

point  of  calL  The  point  in  a  program  from  which  a 
subroutine  or  function  is  called. 

poke:  To  store  information  directly  into  a 
location  in  the  computer's  memory. 

pop:  To  remove  the  top  entry  from  a  stack, 
moving  the  stack  pointer  to  the  entry  below  it. 
Synonymous  with  pull.  Compare  push. 

port:  In  the  Apple  lie,  slots  are  called  ports. 

power  supply:  A  circuit  that  draws  electrical 
power  from  a  power  outlet  and  converts  it  to  the 
kind  of  power  the  computer  can  use. 

power  supply  case:  The  metal  case  inside  most 
Apple  II  and  Macintosh  computers  that  houses  the 
power  supply.  The  Apple  lie  uses  an  external 
power  supply  case. 

PR#:  An  Applesoft  BASIC  command  that  sends 
output  to  a  slot  or  a  machine-language  program.  It 
specifies  an  output  routine  in  the  ROM  on  a 
peripheral  card  or  in  a  machine-language  routine 
in  RAM  by  changing  the  address  of  the  standard 
output  routine  used  by  the  computer. 

precedence:  The  order  in  which  operators  are 
applied  in  evaluating  an  expression.  Precedence 
varies  from  language  to  language,  but  usually 
resembles  the  precedence  rules  of  algebra. 
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printed-circult  board:  A  hardware  component  of 
a  computer  or  other  electronic  device,  consisting 
of  a  flat,  rectangular  piece  of  rigid  material, 
commonly  Fiberglas,  to  which  integrated  circuits 
and  other  electronic  components  are  connected. 

procedure:  In  the  Pascal  and  Logo  programming 
languages,  a  set  of  instructions  that  work  as  a  unit; 
approximately  equivalent  to  the  term  subroutine 
in  BASIC. 

processor:  The  hardware  component  of  a 
computer  that  performs  the  actual  computation  by 
directly  executing  instructions  represented  in 
machine  language  and  stored  in  main  memory. 
See  microprocessor. 

ProDOS:  An  Apple  II  operating  system  designed 
to  support  hard  disk  drives  like  the  ProFile,  as  well 
as  floppy  disk  storage  devices.  ProDOS  stands  for 
Professional  Disk  Operating  System.  Compare 
Disk  Operating  System  (DOS). 

ProDOS  command:  Any  one  of  the  28 

commands  recognized  by  ProDOS. 

program:  (n)  A  set  of  instructions  describing 
actions  for  a  computer  to  perform  in  order  to 
accomplish  some  task,  conforming  to  the  rules 
and  conventions  of  a  particular  programming 
language,  (v)  To  write  a  program. 

program  line:  The  basic  unit  of  an  Applesoft 
BASIC  program,  consisting  of  one  or  more 
statements  separated  by  colons  (:). 

programming  language:  A  set  of  symbols  and 
associated  rules  or  conventions  for  writing 
programs.  BASIC,  Logo,  and  Pascal  are 
programming  languages. 

prompt:  A  message  on  the  screen  that  tells  you  of 
some  need  for  response  or  action.  A  prompt 
usually  takes  the  form  of  a  symbol,  a  message,  a 
dialog  box,  or  a  menu  of  choices. 


prompt  character:  A  text  character  displayed  on 
the  screen,  usually  just  to  the  left  of  a  cursor, 
where  your  next  action  is  expected.  The  prompt 
character  often  identifies  the  program  or 
component  of  the  system  that's  prompting  you. 
For  example,  Applesoft  BASIC  uses  a  square 
bracket  prompt  character  (] );  Integer  BASIC,  an 
angle  bracket  (>);  and  the  system  Monitor 
program,  an  asterisk  (*). 

prompt  line:  A  specific  area  on  the  display 
reserved  for  prompts. 

protocol:  A  formal  set  of  rules  for  sending  and 
receiving  data  on  a  communication  line. 

Protocol  Converter:  A  set  of  machine  language 
routines  used  in  the  Apple  II  family  for  performing 
block  device  I/O.  See  Smartport. 

push:  To  add  an  entry  to  the  top  of  a  stack, 
moving  the  stack  pointer  to  point  to  it.  Compare 

pop- 
queue:  A  list  in  which  entries  are  added  at  one  end 
and  removed  at  the  other,  causing  entries  to  be 
removed  in  first-in,  first-out  (FIFO)  order. 
Compare  stack. 

QWERTY  keyboard:  The  standard  layout  of  keys 
on  a  typewriter  keyboard;  its  name  is  formed  from 
the  first  six  letters  on  the  top  row  of  letter  keys. 
Compare  Dvorak  keyboard. 

radio-frequency  (RF)  modulator:  A  device  that 
makes  your  television  set  work  as  a  monitor. 

RAM:  See  random-access  memory. 
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random-access  memory  (RAM):  Memory  in 
which  information  can  be  referred  to  in  an 
arbitrary  or  random  order.  As  an  analogy,  a  book 
is  a  random-access  storage  device  in  that  it  can  be 
opened  and  read  at  any  point.  RAM  usually  means 
the  part  of  memory  available  for  programs  from  a 
disk;  the  programs  and  other  data  are  lost  when 
the  computer  is  turned  off  A  computer  with  512K 
RAM  has  512  kilobytes  available  to  the  user. 
(Technically,  the  read-only  memory  [ROM]  is  also 
random  access,  and  what's  called  RAM  should 
correctly  be  termed  read-write  memory^ 
Compare  read-only  memory,  read-write 
memory. 

random-access  text  file:  A  text  file  that  is 
partitioned  into  an  unlimited  number  of  uniform- 
length  compartments  called  records.  When  you 
open  a  random-access  text  file  for  the  first  time, 
you  must  specify  its  record  length.  No  record  is 
placed  in  the  file  until  written  to.  Each  record  can 
be  individually  read  from  or  written  to — hence, 
random-access. 

raster:  The  pattern  of  parallel  lines  making  up  the 
image  on  a  video  display  screen.  The  image  is 
produced  by  controlling  the  brightness  of 
successive  points  on  the  individual  lines  of  the 
raster. 

read:  To  transfer  information  into  the  computer's 
memory  from  outside  the  computer  (such  as  a  disk 
drive  or  modem)  or  into  the  computer's  processor 
from  a  source  external  to  the  processor  (such  as 
the  keyboard  or  main  memory). 

read-only  memory  (ROM):  Memory  whose 
contents  can  be  read,  but  not  changed;  used  for 
storing  firmware.  Information  is  placed  into 
read-only  memory  once,  during  manufacture;  it 
then  remains  there  permanently,  even  when  the 
computer's  power  is  turned  off.  Compare 
random-access  memory,  read-write 
memory. 


read-write  memory:  Memory  whose  contents 
can  be  both  read  and  changed  (or  tvritten  to).  The 
information  contained  in  read-write  memory  is 
erased  when  the  computer's  power  is  turned  off" 
and  is  permanently  lost  unless  it  has  been  saved  or 
a  disk  or  other  storage  device.  Compare  random- 
access  memory,  read-only  memory. 

real  number:  In  computer  usage,  a  number  that 
may  include  a  fractional  part;  represented  inside 
the  computer  in  floating-point  form.  Because  a 
real  number  is  of  infinite  precision,  this 
representation  is  usually  approximate.  Compare 
integer. 

receive  data  register:  A  read-only  register  in  the 
serial  port  ACIA  (at  $C098  for  port  1  and  $C0A8 
for  port  2)  that  stores  the  most  recent  character 
successfully  received. 

register:  A  location  in  a  processor  or  other  chip 
where  an  item  of  information  is  held  and  modified 
under  program  control. 

relational  operator:  An  operator,  such  as  >,  that 
operates  on  numeric  values  to  produce  a  logical 
result.  Compare  arithmetic  operator,  logical 
operator. 

Request-To-Send:  An  RS-232-C  signal  from  a 
DTE  to  a  DCE  that  serves  to  prepare  the  DCE  for 
data  transmission. 

reserved  word:  A  word  or  sequence  of  characters 
reserved  by  a  programming  language  for  some 
special  use  and  therefore  unavailable  as  a  variable 
name  in  a  program. 

resident:  See  memory-resident,  disk- 
resident. 

retm'n  address:  The  point  in  a  program  to  which 
control  returns  on  completion  of  a  subroutine  or 
function. 

RF  modulator:  See  radio-frequency 
modulator. 

RGB  monitor:  A  type  of  color  monitor  that 
receives  separate  signals  for  each  color  (red, 
green,  and  blue).  See  composite  video. 
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ROM:  See  read-only  memory. 

routine:  A  part  of  a  program  that  accomplishes 
some  task  subordinate  to  the  overall  task  of  the 
program. 

row:  A  horizontal  arrangement  of  character  cells 
or  graphics  pixels  on  the  screen. 

RS-232  cable:  Any  cable  that  is  wired  in 
accordance  with  the  RS-232  standard,  which  is  the 
common  serial  data  communication  interface 
standard. 

RTS:  See  Request-To-Send. 

run:  (1)  To  execute  a  program.  When  a  program 
runs,  the  computer  performs  the  instructions. 
(2)  To  load  a  program  into  main  memory  from  a 
peripheral  storage  medium,  such  as  a  disk,  and 
execute  it. 

save:  To  store  information  by  transferring  the 
information  from  main  memory  to  a  disk.  Work 
not  saved  disappears  when  you  turn  off  the 
computer  or  when  the  power  is  interrupted. 

screen:  See  display  screen. 

scrolL  To  move  all  the  text  on  the  screen  upward 
or  downward,  and,  in  some  cases,  sideways.  See 
viewport,  windo^v. 

serial  interface:  An  interface  in  which 
information  is  transmitted  sequentially,  a  bit  at  a 
time,  over  a  single  wire  or  channel.  Compare 
parallel  interface. 

setup  time:  The  amount  of  time  a  signal  must  be 
valid  in  advance  of  some  event.  Compare  hold 
time.  See  valid  signal 

silicon  (Si):  A  solid,  crystalline  chemical  element 
from  which  integrated  circuits  are  made.  Silicon  is 
a  semiconductor;  that  is,  it  conducts  electricity 
better  than  insulators,  but  not  as  well  as  metallic 
conductors.  Silicon  should  not  be  confused  with 
silica — that  is,  silicon  dioxide,  such  as  quartz, 
opal,  or  sand — or  with  silicone,  any  of  a  group  of 
organic  compounds  containing  silicon. 


simple  variable:  A  variable  that  is  not  an  element 
of  an  array. 

68000:  The  microprocessor  used  in  the 
Macintosh  and  Macintosh  Plus. 

6502:  The  microprocessor  used  in  the  Apple  II,  in 
the  Apple  II  Plus,  and  in  early  models  of  the 
Apple  He. 

65C02:  The  microprocessor  used  in  the  enhanced 
Apple  He,  the  extended  keyboard  He,  and  the 
Apple  lie. 

slot:  A  narrow  socket  inside  the  computer  where 
you  can  install  peripheral  cards.  Also  called  an 
expansion  slot. 

Smartport:  A  set  of  machine  language  routines 
used  in  the  Apple  II  family  for  performing  block 
device  I/O.  See  Protocol  Converter. 

soft  switch:  Also  called  a  software  switch;  a 
means  of  changing  some  feature  of  the  computer 
from  within  a  program.  For  example,  DIP  switch 
settings  on  Image  Writer  printers  can  be 
overridden  with  soft  switches.  Specifically,  a  soft 
switch  is  a  location  in  memory  that  produces  some 
special  effect  whenever  its  contents  are  read  or 
written. 

software:  A  collective  term  for  programs,  the 

instructions  that  tell  the  computer  what  to  do. 
They're  usually  stored  on  disks.  Compare 
hardware,  firmware. 

source  code:  See  source  program. 

source  program:  The  form  of  a  program  given  to 
a  language  translator,  such  as  a  compiler  or 
assembler,  for  conversion  into  another  form; 
sometimes  called  source  code.  Compare  object 
program. 

space  character:  A  text  character  whose  printed 
representation  is  a  blank  space,  typed  from  the 
keyboard  by  pressing  the  Space  bar. 


Glossary 


529 


SPACE  parity:  A  bit  value  of  0  appended  to  a 
binary  number  for  transmission.  The  receving 
device  can  look  for  this  value  on  each  character  as 
a  means  of  error  checking. 

stack:  A  list  in  v^hich  entries  are  added  (pushed) 
or  removed  (popped)  at  one  end  only  (the  top  of 
the  stack),  causing  them  to  be  removed  in  last-in, 
first-out  (LIFO)  order.  Compare  queue. 

standard  instruction:  An  instruction 
automatically  present  when  no  superseding 
instruction  has  been  received. 

start  bit:  A  transition  from  a  MARK  signal  to  a 
SPACE  signal  for  one  bit-time,  indicating  that  next 
string  of  bits  represents  a  character. 

starting  value:  The  value  assigned  to  the  index 
variable  on  the  first  pass  through  a  loop. 

start  up:  To  get  the  system  running.  Starting  up  is 
the  process  of  first  reading  the  operating  system 
program  from  the  disk,  and  then  running  an 
application  program. 

startup  disk:  A  disk  with  all  the  necessary 
program  files — such  as  the  Finder  and  System  files 
contained  in  the  System  folder  in  Macintosh — to 
set  the  computer  into  operation.  In  Apple  II, 
sometimes  called  a  boot  disk. 

statement:  A  unit  of  a  program  in  a  high-level 
language  that  spjecifies  an  action  for  the  computer 
to  perform.  A  statement  typically  corresponds  to 
several  instructions  of  machine  language. 

status  register:  A  location  in  the  ACIA  (at  $C099 
for  port  1  and  $C0A9  for  port  2)  that  stores  the 
state  of  two  RS-232-C  signals  and  the  state  of  the 
transmit  and  receive  data  registers,  as  well  as  the 
outcome  of  the  most  recent  character  transfer. 

step  value:  The  amount  by  which  the  index 
variable  changes  on  each  pass  through  a  loop. 

stop  bit:  A  MARK  signal  following  a  data  string  (or 
the  optional  parity  bit),  indicating  the  end  of  a 
character. 


string:  An  item  of  information  consisting  of  a 
sequence  of  text  characters. 

strobe:  A  signal  whose  change  is  used  to  trigger 
some  action. 

subroutine:  A  part  of  a  program  that  can  be 
executed  on  request  from  another  point  in  the 
program  and  that  returns  control,  on  completion, 
to  the  point  of  the  request. 

synchronous:  A  mode  of  data  transmission  in 
which  a  constant  time  interval  exists  between 
transmission  of  successive  bits,  characters,  or 
events.  Compare  asynchronous. 

synchronous  transmission:  A  transmission 
process  that  uses  a  clocking  signal  to  ensure  an 
integral  number  of  unit  (time)  intervals  between 
any  two  characters.  Compare  asynchronous 
transmission. 

syntax:  (1)  The  rules  governing  the  structure  of 
statements  or  instructions  in  a  programming 
language.  (2)  A  representation  of  a  command  that 
specifies  all  the  possible  forms  the  command  can 
take. 

system:  A  coordinated  collection  of  interrelated 
and  interacting  parts  organized  to  perform  some 
function  or  achieve  some  purpose — for  example, 
a  computer  system  comprising  a  processor, 
keyboard,  monitor,  and  disk  drive. 

system  configuration:  See  configuration. 

system  program:  A  program  that  makes  the 
resources  and  capabilities  of  the  computer 
available  for  general  purposes,  such  as  an 
operating  system  or  a  language  translator. 
Compare  application  program. 

system  software:  The  component  of  a  computer 
system  that  supports  application  programs  by 
managing  system  resources  such  as  memory  and 
I/O  devices. 
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tab:  An  ASCII  character  that  commands  a  device 
such  as  a  printer  to  start  printing  at  a  preset 
location  (called  a  tab  stop).  There  are  two  such 
characters:  horizontal  tab  (hex  09)  and  vertical  tab 
(hex  OB).  TAB  works  like  the  tabs  on  a  typewriter. 

television  set:  A  display  device  capable  of 
receiving  broadcast  video  signals  (such  as 
commercial  television  broadcasts)  by  means  of  an 
anteima.  Can  be  used  in  combination  with  a 
radio-frequency  modulator  as  a  display  device  for 
the  Apple  II  family  of  computers.  Compare  video 
monitor. 

text:  (1)  Information  presented  in  the  form  of 
readable  characters.  (2)  The  display  of  characters 
on  a  display  screen.  Compare  graphics. 

text  windo'w:  An  area  on  the  video  display  screen 
within  which  text  is  displayed  and  scrolled. 

traces:  Electrical  paths  that  connect  the 
components  on  a  circuit  board. 

transistor-transistor  logic  (TTL):  (1)  A  family 
of  integrated  circuits  having  bipolar  circuit  logic; 
TTLs  are  used  in  computers  and  related  devices. 
(2)  A  standard  for  interconnecting  such  circuits, 
which  defines  the  voltages  used  to  represent 
logical  zeros  and  ones. 

transmit  data  register:  A  location  in  the  ACIA 
(at  location  $C098  for  port  1  and  $C0A8  for  port  2) 
that  holds  the  current  character  to  be  transmitted. 

troubleshoot:  To  locate  and  correct  the  cause  of 
a  problem  or  malfunction,  especially  in  hardware. 
Compare  debug. 

TTL:  See  transistor-transistor  logic. 

turnkey  disk:  See  startup  disk. 

unary  operator:  An  operator  that  applies  to  a 
single  operand.  For  example,  the  minus  sign  (-)  in 
a  negative  number  such  as  -6  is  a  unary  arithmetic 
operator.  Compare  binary  operator. 

unconditional  branch:  A  branch  that  does  not 
depend  on  the  truth  of  any  condition.  Compare 
conditional  branch. 


value:  An  item  of  information  that  can  be  stored 
in  a  variable,  such  as  a  number  or  a  string. 

variable:  (1)  A  location  in  the  computer's 
memory  where  a  value  can  be  stored.  (2)  The 
symbol  used  in  a  program  to  represent  such  a 
location.  Compare  constant. 

vector:  (1)  The  starting  address  of  a  program 
segment,  when  used  as  a  common  point  for 
transferring  control  from  other  programs.  (2)  A 
memory  location  used  to  hold  a  vector,  or  the 
address  of  such  a  location. 

video:  (1)  A  medium  for  transmitting  information 
in  the  form  of  images  to  be  displayed  on  the 
screen  of  a  cathode-ray  tube.  (2)  Information 
organized  or  transmitted  in  video  form. 

video  monitor:  A  display  device  that  can  receive 
video  signals  by  direct  connection  only,  and  that 
cannot  receive  broadcast  signals  such  as 
commercial  television.  Can  be  connected  directly 
to  the  computer  as  a  display  device.  Compare 
television  set. 

viewport:  All  or  part  of  the  display  screen  used  by 
an  application  program  to  display  a  portion  of  the 
information  (such  as  a  document,  picture,  or 
worksheet)  on  which  a  program  is  working. 
Compare  window. 

voliune:  A  general  term  referring  to  a  storage 
device;  a  source  of  or  a  destination  for 
information.  A  volume  has  a  name  and  a  volume 
directory  with  the  same  name.  Its  information  is 
organized  into  files. 

■warm  start:  The  process  of  transferring  control 
back  to  the  operating  system  in  response  to  a 
failure  in  an  application  program.  Compare  cold 
start. 

window:  The  portion  of  a  collection  of 
information  (such  as  a  document,  picture,  or 
worksheet)  that  is  visible  in  a  viewport  on  the 
display  screen.  Compare  viewport. 
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word:  A  group  of  bits  that  is  treated  as  a  unit;  the 
number  of  bits  in  a  word  is  a  characteristic  of  each 
particular  computer. 

write:  To  transfer  information  from  the  computer 
to  a  destination  external  to  the  computer  (such  as  a 
disk  drive,  printer,  or  modem)  or  from  the 
computer's  processor  to  a  destination  external  to 
the  processor  (such  as  main  memory). 

write-enable  notch:  The  square  cutout  on  one 
edge  of  a  5.25-inch  disk's  jacket.  If  there  is  no 
write-enable  notch,  or  if  it  is  covered  with  a  write- 
protect  tab,  the  disk  drive  can  read  information 
from  the  disk,  but  cannot  write  on  it. 

write  protect:  To  protect  the  information  on  a 
5.25-inch  disk  by  covering  the  write-enable  notch 
with  a  write-protect  ub,  preventing  the  disk  drive 
from  writing  any  new  information  onto  the  disk. 
Compare  copy  protect. 


write-protect  tab:  (1)  A  small  adhesive  sticker 
used  to  write  protect  a  5.25-inch  disk  by  covering 
the  write-enable  notch.  (2)  The  small  plastic  tab  i 
the  corner  of  a  3.5-inch  disk  jacket.  You  lock  (wril 
protect)  the  disk  by  sliding  the  tab  toward  the  edg 
of  the  disk;  you  unlock  the  disk  by  sliding  the  tab 
back  so  that  it  covers  the  rectangular  hole. 

X  register:  One  of  the  two  index  registers  in  the 
6502  microprocessor. 

Y  register:  One  of  the  two  index  registers  in  the 
6502  microprocessor. 

zero  page:  The  first  page  (256  bytes)  of  memory 
in  the  Apple  II  family  of  computers,  also  called 
page  zero.  Since  the  high-order  byte  of  any 
address  in  this  page  is  zero,  only  the  low-order 
byte  is  needed  to  specify  a  zero-page  address;  thi 
makes  zero-page  locations  more  efficient  to 
address,  in  both  time  and  space,  than  locations  i 
any  other  page  of  memory. 
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mouse    187 
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Integer  BASIC  308,  330,  348, 

356,  388 
integrated  circuits   13,  241-248 
Integrated  Woz  Machine  OWM)   15, 

247-248,  273,  365 
internal  converter  234-235 

Sfjecifications   234 
Interrupt  Request   281 


interrupts  74,  331-347,  357 

bypassing   345-347 

external   342-343 

EXTINT    276 

handling  334-345 

keyboard   341-342 

mouse   50,   187-188,   190-191, 
339-340,  345-346,  354 

serial   343-345 

Smartport    130,   138 

sources   338-339 

VBlInt   187-188,   190,  243 

vectors  333-334 

XInt    190 

YInt    190 
inverse  characters  69,  70,  88-89 
INVERSE  command    90,  214,   228 
inverse  display  214 
inverse  flag  69,  70 
I/O    357 

cassette   364 

disk    273-274,  36 1 

disk  drive    120-121 

links   56-58 

memory  expansion  card    123 

port   71-74 

serial   274-282,  361-362 

Smartport    123-124 
lOError  $27  error    150 
lOUDis  switch  45,  103,  189,  355 
IRQ    334 

ISO  keyboard   371 
Italian  keyboard  378-379 


jacks 

headphone   8,  256 
output  8,  256 

joysticks   198,  199 
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K  command   156,  170 

keyboard  3-7,   254-255,   357-359 

Canadian  375 

characteristics   79 

circuit  diagram  254 

Dvoralc  6-7,  358,  370 

encoder   78 

English   372 

features   3 

flag  78 

French   373-374 

German   376-377 

input  buffer  36,  38 

inputs   78-82 

interrupts   340-342 

ISO    371 

Italian   378-379 

layouts  and  codes  3,  6-7, 
366-381 

Sholes   6,  358,  367-368 

signals   255 

specifications  3 

strobe   78,  339,  353 

switch  3,  6-7 

Western  Spanish  380-381 
keyboard  input  switch  (KSW)  57, 

71,   101 
Keyin  routine   56-57,  58-59,  78 
keys 

cursor  movement  4,  62 

modifier   5,  81 

special  function  4 
KSW  57,  71,  101 
KSWH   57 
KSWL  57 


languages   329-330 
last  opened  location   205 
L  command    156,  170 


Left  Arrow  4,  63 
LF    See  line  feed 
line  feed   114,  l64,  179 
LIST  command   220-221,  225 
Logo  II   330 
lowercase  characters  395 
low-resolution  graphics  94-95, 
266-267 
map    109 

M 

Machine  Language  Interface    125 
machine-language 

programs   219-221 
main  logic  board   12-15 
main  memory  42-A4,  l6l,  175, 
269 

screen  holes  313-314 
main  RAM  22 
maps 

display  address  259-261 

display  page    105-111 

48K  memory  37 

memory   20,   308-321 

ROM  397,  398 
M  command   156,  171 
memory 

addressing   248-253 

auxiliary  42^4,  74,  106, 
160-161,  175,  269,  315 

bank-switched   24-35 

changing  contents   208-210 

comparing  data   211-212 

dump    206-208 

examining   206 

48K   36-39 

main  42-44,  l6l,  175,  269, 
313-314 

maps   20,   308-321 

moving  data   210-211 

RAM    13 

range    207 

ROM   13 


memory  addresses   20 

display   258,  260 

hardware  page  316-321 

port  I/O   72-73 

p>ort  screen  hole   74 

text  window  68-69 
memory  bus  organization   249 
memory  expansion   14 

mouse  and   191,  195 
memory  expansion  card   120,  250, 
291 

entry  points    122 

I/O    123 

startup  routine   122 
memory  management  unit 

(MMU)   15,  241-242,  365 
memory  pages 

$00  (zero  page)   20,  24,  25, 
308-311 

$01  (stack)  20,  24,  25 

$02  (input  buffer)   36 

$03  (global  storage,  vectors)   36, 
312 

$04-$07  (TLPl)   36-38 

$08  (communication  port 
buffers)   38 

$08-$0B  (TLP2)   38 

$20-$3F  (HRPl)   38 

$40-$5F  (HRP2)   39 

$D0-$FF    26 
microprocessor    13,  18-19 

See  also  65C02  microprocessor 
Mini-Assembler 

address  formats   226 

instruction  formats   226 

starting    223-224 

using   224-226 
mixed-mode  displays  98-99 
MIXED  switch    102,  243,  354 
MLI    125 

modem    177-178 
modem  port,  commands   170-172 
modifier  keys  5,  81 
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Monitor  5,  23,  36,  57,  59,  63.  l6l, 
176,  258,  312,  356 

entry  points   322,  326-327 

firmware  routines   112-115 

game  support   201 

input  routines  82 

interrupts  74 

memory  location   204 

output   270 

speaker  routines  84 

vectors   326-327 
Monitor  commands 

advanced   2X6-218 

debugging   221 

machine-language 
program   219-221 

memory   205-212 

register    212-213 

repeating   217-218 

summary   227-229 

syntax   205 
mouse 

as  hand  controller  198 

assembly-language 
support   195-196 

BASIC  support   195-196 

button  signals   286 

circuits   285 

connector  284 

connector  signals  284 

defaults   50 

firmware  entry  points  23 

firmware  routines  193-194 

inputs    186-198,  282-286,  363 

interrupts   50,  339-340, 
345-346,  354 

I/O  firmware  support   191-196 

operating  modes    187-188 

Pascal  supfKjrt   195 

port  characteristics   186 

screen  holes    196-197 

soft  switches   189-191 

waveforms   283 
mouse  port 

addresses   325 

I/O  firmware  protocol    195 

screen  holes   197 
MouseText  69,  70,  88,  90,  360 

characters  91 


MouXl  switch   190 
MouYl  switch  190 
MoveAux  routine   42-43 
MOVE  command   210-211, 

216-217,   227 
movement/button  interrupt 

mode    188 
movement  interrupt 

mode    187-188 
multiplexing  251 
RAM  address   252 

N 

N  command   228 
nD  command   156,  170 
negative  decimal   388-389 
next  changeable  location  205, 

208-209 
nibbles  94,  384,  386 
nnB  command   156,  170 
nnn  command    156,  170 
nnnN  command   157,  171,  362 
NoDrive  $28  error    151 
NonFatal  $50-$7F  error    151 
normal  characters  69,  70,  88-89 
NORMAL  command   90,  214,  228 
normal  display  214 
NoWrite  $2B  error   150 
nP  command    157,  171 
NTSC  86,  96,  97,  257,  270 
#6  command   155 
#7  command   169 
#8  command   169 


O  Control-K  215 

OffLine  $2F  error   151 

Open  Apple  4,  52,  81,  200,  221, 

222,  358 
Op)en  Apple-Control-Reset   52, 

121,  162,  176,  361 
OPEN  call    127,  140-141 
operating  systems   214,  328-329 
output  jack   256 


outputs 

hand  controller   363-364 

speaker   82-84 

strobe    24 

video  display   116-118 

video  signal   270-273 
output  subroutines   64-70 

COut  64 

COutl    65 

C30utl    65-67 
overflow  bit  44 


paddles    198,  287 

Page  1    20,  36-38,  50,  269 

high-resolution   95 

text    100,   106 
Page  IX  38,  269 

text    100 
Page  2   20,  39 

high-resolution   95 

text    100 
Page2  switch   45,  102,  241,  243, 

354 
Page  2X  38,  39 

pages,  display   See  display  pages 
pages,  memory   See  memory 

pages 
PAL   257 
parity  bit   l63 

Pascal   56,  68,  72,  124,  169,  330, 
332 

mouse  and    195 

video  control  functions    117-118 
Pascal  Operating  System  329 
PdlO   287 
Pdll    287 
PEEK    329 
period  (.)  206 
peripheral-card  memory 

spaces   352-353 
peripheral  identification  numbers 

(PIN)    389-390 
PInit  routine    ll6 
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pinouts 

GLU  246 

lOU  243 

IWM  247 

MMU  242 

RAM   251 

ROM   249,  250 

6551    277 

TMG   245 

video  expansion  connector   272 
PLOT  routine    112,  114 
POKE   329 
ports 

characteristics  71 

disk  I/O    120-121 

entry  points  71 

I/O   71-74 

mouse    186,  325 

printer    155-157 

ROM  space  73 

screen  hole  RAM  space   74 

serial   275 

serial  port  1   22,  154-165 

serial  port  2   22,  38,  167-184 

video  output  86 
PosMouse  routine    193 
power  converter   234-235 

sjjecifications  234 
fxjwer  light  3,  7 
power-on  reset  50 
power  supply   11-12 

sp>ecifications   233,  383 
PR#n  command   57 
PR#0  command    198 
PR#1  command    155,   159,  162, 

181 
PR#2  command   169,  171,  172, 

179,  181,   183,  184 
PR#3  command   90,   196 
PR#4  command   196,   198 
PR#7  command   328 
PRB12  routine    112,  114 
PrByte  routine    112,  115 
PRead  routine    ll6,  201 
P  register   18,  213 
PrErr  routine    112,  115 


PrHex  routine    112,  115 
primary  character  set  69,  70,  88, 

359 
PRINTER   command    155 
printer  port,  commands    155-157 
PrntAX  routine    113,  115 
processor  status  register   18,  213 
ProDOS   51,  57,  124,  155,  169, 
204,  214,  312,  328,  332 
Machine  Language  Interface   125 
program  counter  (PC)   18 
prompt  characters  59 
Protocol  Converter    124 
PStatus  routine    118 
PTrig  switch   190 
PWrite  routine   117 


Q 

Q  command   171 
question  mark  (?)  59 
blinking   169,  179 

R 

RAM    13 

addressing   251-253 

auxiliary  22,  184 

main   22 

memory  expansion  card  123 

pes  ipheral-card  353 

port  screen  hole   74 

refreshing   251-252 

Smartport   126 

timing    252-253 
RAM  addresses   22,  351 

multiplexing  252 
RAMRd  switch  39,  44,  242 
RAMWrt  switch  39,  44,  242 
R  command    157,  171 
Rd63  switch   190 
RdSOCol  switch    102 
Rd80Store  switch  45,  102 
RdAltChar  switch   102 
RdAltZP  switch   28 
RdBnk2  switch  28 
RdBtnO  switch   190 


RdChar  routine  82 

RdDHiRes  switch   46,  103 

RdHiRes  switch   45,  103 

RdlOUDis  switch   46,  103,  189 

RdKey  routine   58,  78,  341 

RdLCRAM  switch   28 

RdMIXED  switch    102 

RdPage2  switch   45,  102 

RdRAMRd  switch   39 

RdRAMWrt  switch  39 

RdTEXT  switch    102 

RdVBlMsk  switch    190 

RdXOEdge  switch   189 

RdXYMsk  switch   189 

RdYOEdge  switch    190 

READ  BLOCK  call    126,  132-133 

READ  call    127 

ReadMouse  routine    188,  192,  193 

registers    18-19 

changing  213 

command   280 

control   278-279 

examining  213 

shift   263,  268 

Smartport   125 

status    18,  130,  213,  281 

transmit/receive   282 
REMIN  command    169 
REMOUT  command   l69 
Request  to  Send  (RTS)   280 
Reset   3,  4,  81,  358 
reset  routine   49-50 
reset  vectors   50-53 
Return   4,  60,  169,  204,  206,  208, 

209,  213,  215,  224,  227 
return  from  subroutine  (RTS)   57, 

219 
retype   63 
RGB   269 

Right  Arrow  4,  63,  82 
ROM   13 

addresses   22-23,  351-352 

addressing  249-250 

Autostart   356 

character  generator   14,  266,  267 

Monitor  356 

peripheral-card  352 


Index 


541 


ROMENl  250 
ROMEN2  250 
ROM  map 

auxiliary  side   398 

main  side   397 
ROM  space 

expansion   74 

port   73 
row-address  strobe  (RAS)   252 
RstVBl  switch    190 
RstXInt  switch    189,  242 
RstXY  switch    189 
RstYInt  switch    190,  242 
RTS 

Request  to  Send   280 

return  from  subroutine   57,  219 


S  command   157,  171 
screen  holes   38,  312-315 

auxiliary  memory  315 

main  memory   313-314 

mouse    196-197 

serial  port  1    I6O-I6I 

serial  port  2    174-175 
SCRN  routine    113,   115 
serial  buffering   343-344 
serial  cards  361-362 
serial  I/O   274-282,  361-362 

buffers   362 
serial  port  361-362 

circuits   275 

connectors   278 

connector  signals   278 
serial  port  1    22,  154-165 

addresses   323 

at  startup    159 

carriage  return  and  line  feed    164 

characteristics    154,  I6 1-165 

data  format  and  baud  rate   l63 

displaying  output   l65 

hardware  page  locations   159 

I/O  firmware  support   I60 

screen  holes    I6O-I6I 

sending  special  characters   l65 

using    155-158 


serial  port  2   22,  38,  167-184 

addresses   324 

at  startup    173 

carriage  return  and  line  feed    179 

characteristics    I68-I69, 
176-184 

commands    170-172 

data  format  and  baud 
rate    177-178 

hardware  page  locations   173-174 

I/O  firmware  support   174 

routing  input  and 
output    179-184 

screen  holes    174-175 

using    169-173 
ServeMouse  routine    187,  188, 

193,  339 
SetCol  routine    113,  115 
SetMouse  routine    192,  193,  339 
SetPWRC  routine   53 
Shift   5,  81,  255,  358 
shift  register    263,  268 
Sholes  keyboard   6,  358,  367-368 
signals 

BREAK    163 

character  generator   266 

clock   239-241 

disk  drive  connector   274 

GLU   246 

hand  controller   199-200,  289, 
364 

hand  controller  connector   287 

lOU   243-244 

IWM  247 

keyboard    255 

MMU  242 

mouse  button   286 

mouse  connector    187,  284 

RAM  timing  253 

ROM   250 

serial  p>ort  connector   278 

65C02    305 

6551    277 

synchronization  257 

timing    264-265 

TMG   245 

video  expansion 
connector   272-273 

video  output   270-273 


65C02  microprocessor    13,  75, 
237-241,    297-307 

addressing  modes   26,  302,  304 

block  diagram   237-238,  299 

characteristics   300-301 

data  sheets   298-307 

enhancements   301 

instruction  mnemonics  302 

instruction  set  306 

interrupt  handling  333 

operational  codes   306-307 

pin  configuration   299 

pin  function  300 

programming  model   303 

ratings   300 

registers    18-19 

signal  description   305 

specifications   239 

timing   239-241,   302 

versus  6502  297-298 
SLOTC3ROM  switch  354 
SLOTCXROM  switch  354 
Smart  fxsrt 

calls    125-148 

commands  and  parameters    149 

error  codes    150-151 

I/O  interface    123-124 

locating    124 

soft  switches   20,  24 

bank  selector   27 

display   50,   101-105 

mouse    189-191 
Solid  Apple   4,  52,  81,  200,  221, 

222,  358 
Solid  Apple-Control-X  341 
speaker   359 

circuit  diagram   256 

outputs   82-84 

volume  control   8,  256 
sp>ecial  characters  393 
sfsecial  function  keys  4 
sfsecifications 

environmental    232 

power  supply  233,  383 

65C02    239 
S  register    18,  213 
stack  pointer    18,  213 
startup    121-123 
STATUS  call    126,   128-132 
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status  register,  ACIA    130,  281 
STEP   command    221-223 
stop-list  function   67 
STORE  command   216,  227 
strobes 

column-address  252 

keyboard   78,  255,  339,  353 

outputs   24 

row-address   252 
Super  Serial  Card    179,  36l,  362 
SwO    287 
Swl    287 
switch  inputs  200 
synchronization  signals   257 


Tab   4,  358 

T  command    171,   180-183 
terminal  mode    179,  184 
text,  character  sets   88-89 
text  display  263 

characteristics   93 

40-column  5,  50,  86,  91,  92, 
94,  107,  259,  261,  358 

80-column   5,  38,  64,  68,  86, 
91,  92,  100,  106,   108, 
269,  358 

switching  93 
text  Page  1    100,  106 
text  Page  IX   100 
text  Page  2    100 
TEXT  switch    102,  243,  354 
text  window  68-69 
timing  generator  (TMG)    15,  245, 

365 
TLPl    36 
TLPIX    38 
TLP2    38 
TLP2X    38 
toggle  switches   24 
TRACE  command    221-223 
transmit/receive  register, 

ACIA    282 
transparent  mode    187 


U 

underscore  (_),  blinking   179 
UniDisk  3.5    120,  124,  130,  223 

control  list   138 

I/O  entry  points    122 
Up  Arrow  4 

uppercase  characters  394 
USER  command   218,  228 


validity-check  byte    51,  53 
VBlInt  switch   243 
vectors   36,  56 

interrupt    333-334 

Monitor  326-327 

reset    50-53 
VERIFY  command    211-212,  217, 

227 
vertical  blanking   338,  354,  360 

active  modes    188 
vertical-count  bits   260 
VID   270,  365 
video  counters   257-258 
video  display   257-273,  359-360 

addresses    101 

circuits   262 

I/O  firmware  support   116-118 

modes    261-269 

specifications  87 
video  expansion 

connector  signals    272-273 

output   271-273 
video  output  firmware 

addresses   324 

entry  points   23 
video  output  pott, 

characteristics   86 
video  output  signals   257,  270-273 
VLine  routine    113,  115 
voltage  converter    11-12 
volume  control   8,  256 
VTabZ  routine    113 


W 

warm  start   50,  51,  123 
Western  Spanish 

keyboard   380-381 
WNDW  257 
words  385 

WRITE  BLOCK  call    127,  134-135 
WRITE  call    127,  143-144 


XO   243,   284 

XOEdge  switch    189 

XI    284 

X  command    157,  171 

XFer  routine   42-44,  312 

XInt    190,   354 

XON/XOFF  protocol    171 

X  register    18,  43,  73,  84,  114, 

115,  118,  128,   192,  201, 

213 


YO   243,   284 
YOEdge  switch    190 
Yl    284 
YInt    190,  354 

Y  register    18,  43,  113,  114,  115, 
128,  192,  201,  213 


Z  command    157,  165,  171 
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